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内 容 简 介 


ArcGIS Server 是 功能 强大 的 基于 服务 器 的 地 理 信息 系统 产品 ， 本 书 以 循序 渐进 的 方式 , 通过 大 量 的 实例 
介绍 如 何在 Visual Studio 中 ,使 用 C# 语 言 开发 基于 ArcGIS Server [ff] Web GIS。 全 书 内 容 涉 及 使 用 ArcGIS Server 
开发 Web GIS 的 各 个 层面 ， 包 括 ArcGIS Server 9.2 的 功能 、 架 构 及 安装 介绍 ，ArcGIS Server 的 管理 、 服 务 的 
发 布 以 及 配置 文件 的 使 用 ， 自 定义 工具 与 命令 的 创建 ， 数 据 源 、 图 形 对 象 类 、 任 务 的 自 定义 及 操作 ，ArcGIS 
服务 器 功能 的 扩展 ， 以 及 如 何 直 接 使 用 ArcGIS Server 提供 的 Web 服务 开发 程序 并 对 其 进行 再 封装 。 最 后 介 
绍 了 Web GIS 中 的 安全 、 部 署 以 及 性 能 调 优 应 考虑 的 关键 问题 。 

本 书 适用 于 政府 、 企 业 相关 部 门 的 GIS 研究 与 开发 人 员 ， 也 适用 于 高 等 院 校 地 理学 、 地 理 信 息 系统 、 房 
地 产 、 环 境 科学 、 资 源 与 城乡 规划 管理 、 区 域 经 济 学 等 专业 学 生 参 考 与 学 习 。 本 书 还 适合 作为 各 种 GIS 培训 
学 员 的 学 习 教 材 与 参考 书 。 
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人 类 正面 临 一 个 海量 信息 的 时 代 ， 社 会 的 发 展 、 国 家 与 企业 的 竞争 能 力 越 来 越 依赖 于 对 信息 
的 占有 量 与 处 理 和 利用 能 力 。 而 占 人 类 活动 全 部 信息 80% 的 空间 信息 如 何 更 快 、 更 好 、 更 充分 地 
发 挥 作用 已 成 为 全 球 关注 的 热点 。 空 间 信息 科学 与 技术 正 是 在 这 样 一 个 强烈 的 需求 呼唤 与 应 用 积累 
下 产生 的 一 个 新 兴 高 技术 交叉 学 科 ， 它 结合 空间 技术 、 信 息 技术 和 各 类 应 用 技术 ， 主 要 研究 空间 信 
息 的 获取 、 存 储 、 管 理 、 查 询 、 分 析 、 应 用 、 共 享 、 可 视 表 达 等 理论 、 方 法 与 技术 。“21 世纪 是 
全 球 数字 化 的 时 代 ”《〈 比 尔 。 盖 茨 ) ，“ 十 五 ”期 间 我 国 就 已 将 “数字 城市 ”、“ 数 字 国 土 ”等 列 
入 国民 经 济 和 科技 发 展 重点 计划 ，“ 数 字 北 京 ”、“ 数 字 福 建 ”、“ 数 字 黄 河 ” 等 等 一 些 重大 工程 
即将 大 展 宏 图 ， 地 理 信息 系统 的 研发 任重道远 。 

自 20 世纪 60 年 代 诞生 以 来 , GIS 发 展 迅速 , 应 用 也 日 趋 深 化 和 广泛 , 逐步 融入 信息 技术 CIT) 
的 主流 ， 正 在 成 为 信息 产业 新 的 增长 点 ,是 发 展 潜力 巨大 的 地 理 信息 产业 的 主要 组 成 部 分 之 一 。 如 
今 GIS 的 应 用 已 经 成 为 我 国 国民 经 济 和 社会 信息 化 建设 的 亮点 ， 日 益 深入 到 各 个 专业 领域 和 百姓 
日 常生 活 中 。 

GIS 经 历 了 单机 环境 应 用 向 网 络 环境 应 用 发 展 的 过 程 ， 网 络 环境 GIS 应 用 从 局 域 网 内 容 户 / 服 
Fas (Client/Server, C/S) 结构 的 应 用 向 Internet 环境 下 浏览 器 /服务 器 (Browser/Server，B/S) 结 
构 的 Web GIS 应 用 发 展 。 随 着 Internet 的 发 展 ，Web GIS 开始 逐步 成 为 GIS 应 用 的 主流 ，Web GIS 
相对 于 C/S 结构 而 言 , 具 有 部 署 方 便 、 使 用 简单 、 对 网 络 带 宽 要 求 低 的 特点 ,为 地 理 信息 服务 的 发 
展 葛 定 了 基础 。 

然而 ， 早 期 的 Web GIS 功能 较 弱 ， 主 要 用 于 电子 地 图 的 发 布 和 简单 的 空间 分 析 与 数据 编辑 ， 
难以 实现 较为 复杂 的 图 形 交 互 应 用 (如 GIS 数据 的 修改 和 编辑 、 制 图 ) 和 复杂 的 空间 分 析 ， 还 无 
法 取代 传统 的 C/S 结构 的 GIS 应 用 ， 出 现 了 B/S 结构 与 C/S 结构 并 存 的 局 面 ， 而 C/S 结构 涉及 客 
户 端 与 服务 器 端 之 间 大 量 数据 转 输 ， 无 法 在 互联 网 平台 实现 复杂 的 、 大 规模 的 地 理 信息 服务 。 

B/S 结构 应 用 已 经 由 浏览 器 /网 络 服务 器 /数据 服务 器 (Browser/Web Server/Data Server) 三 层 架 
构 阶 段 进入 到 浏览 器 /网 络 服 务 器 /应 用 服务 器 /数据 服务 器 (Browser/Web Server/Application 
Server/Data Server) 四 层 架 构 阶 段 。 在 新 的 四 层 架 构 中 ， 网 络 服 务 器 和 应 用 服务 器 分 离 ， 并 且 其 间 
还 可 以 插入 二 次 开发 和 扩展 功能 ， 其 中 的 应 用 服务 器 一 般 为 支持 远程 调用 的 组 件 式 GIS 平台 ,或 
由 组 件 式 GIS 平台 封装 而 成 。 将 GIS 复杂 数据 分 析 与 处 理 功能 〈 编 辑 、 拓 扑 关 系 的 构建 、 对 象 关 
系 的 自动 维护 、 制 图 ) 移 到 GIS 应 用 服务 器 上 ， 使 客户 端 与 服务 端的 数据 传输 减少 到 最 少 的 程度 ， 
为 在 Intemet 上 实现 复杂 、 大 规模 的 地 理 信 息 服 务 提供 了 可 能 。 这 一 架构 带 来 的 巨大 优势 是 使 服务 
器 端 具有 极 强 的 扩展 性 ， 因 此 作为 应 用 服务 器 的 组 件 式 GIS 所 具备 的 功能 ， 都 可 以 通过 B/S 结构 
实现 ，Web GIS 不 再 是 只 能 满足 地 图 浏览 和 查询 的 简单 软件 了 ， 而 是 一 个 体系 先进 ， 功 能 强大 的 服 
务 器 端 GIS (Server GIS) 。 新 的 服务 器 端 GIS 将 是 未 来 应 用 发 展 的 主流 。 

ArcGIS Server 是 一 个 基于 Web 的 企业 级 GIS 解决 方案 ， 它 为 创建 和 管理 基于 服务 器 的 GIS 
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应 用 提供 了 一 个 高 效 的 框架 平台 。 它 充分 利用 了 ArcGIS 的 核心 组 件 库 ArcObjects， 并 且 基 于 工业 
标准 提供 Web GIS 服务 。ArcGIS Server 将 GIS 和 网 络 技术 (Web) 两 个 先进 的 技术 结合 在 一 起 : 
GIS 擅长 与 空间 相关 的 分 析 和 处 理 ， 网 络 技术 则 提供 全 球 互 联 ， 促 进 信息 共享 。 这 两 项 技术 协同 工 
作 ， 相 得 益 彰 。 

本 书 通过 大 量 的 实例 ， 详 细 介绍 了 如 何 利用 ArcGIS Server 开发 Web GIS. 


在 第 1 章 中 ， 介 绍 了 GIS 及 其 发 展 和 与 Web 服务 的 联合 ， 并 介绍 了 基于 Web 服务 的 GIS 的 
相关 规范 。 

第 2 章 中 详细 介绍 了 ArcGIS Server 9.2 的 主要 功能 以 及 产品 的 分 类 分 级 ， 并 介绍 了 ArcGIS 
Server 系统 的 整体 架构 及 其 相关 技术 ， 最 后 介绍 了 该 产品 的 安装 过 程 。 

第 3 章 介绍 了 ArcGIS Server 的 管理 、 服 务 的 发 布 以 及 配置 文件 的 使 用 。 

第 4 章 首先 介绍 了 使 用 ArcGIS Server 创建 Web GIS 的 不 同方 法 ， 并 介绍 了 开发 Web GIS 的 
基础 ， 即 Web 应 用 程序 框架 ， 及 该 框架 中 Ajax 的 使 用 ， 最 后 通过 几 个 实例 介绍 了 如 何 创建 自 定义 
的 工具 与 命令 ， 实 现 图 形 与 属性 的 双向 查询 与 展示 。 

第 5 章 介绍 了 ArcGIS Server 中 支持 的 数据 源 类 型 及 其 原理 ， 并 着 重 介绍 了 ArcGIS Server 数 
据 源 的 不 同 层次 的 使 用 与 管理 。 本 章 还 介绍 了 与 数据 源 对 应 的 资源 与 功能 的 操作 。 

第 6 章 通过 两 个 大 的 实例 介绍 了 如 何在 ArcGIS Server 的 Web 应 用 程序 框架 (Web ADF) 中 ， 
无 颖 使 用 自 定义 格式 以 及 存储 的 数据 源 。 

第 7 章 首先 介绍 了 图 形 对 象 类 及 其 操作 的 不 同 层次 ， 然 后 分 别 通过 实例 介绍 如 何在 Web 端 以 
及 GIS 服务 器 端 操作 图 形 对 象 ， 最 后 介绍 了 图 形 对 象 在 不 同 层次 之 间 转 换 的 方法 。 

第 8 章 介绍 了 任务 框架 的 概念 、 组 成 ， 并 介绍 如 何 自 定义 任务 框架 。 

第 9 章 介 绍 如 何 通过 使 用 COM 功能 对 象 以 及 服务 器 对 象 扩展 两 种 方式 来 扩展 ArcGIS 服务 器 
的 功能 。 

第 10 章 则 介绍 了 如 何不 在 ArcGIS Server 的 Web 应 用 程序 框架 中 ， 直 接 使 用 ArcGIS Server 
提供 的 Web 服务 开发 程序 ， 以 及 如 何 对 ArcGIS Server 提供 的 Web 服务 进行 再 封装 ， 为 其 他 应 用 
系统 提供 粗 粒度 的 具有 针对 性 的 Web 方法 。 

第 11 章 介 绍 了 Web GIS 中 应 考虑 的 安全 问题 及 其 措施 ， 以 及 其 部 署 和 性 能 调 优 方 面 的 问题 。 


关于 本 书 的 实例 ， 读 者 可 以 到 图 格 新 知 网 站 (www.booksaga.com) 下 载 其 对 应 的 源 代 码 和 一 
些 相 关 文 件 。 
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地 理 信息 系统 的 发 展 与 Web 服 务 


地 理 信 息 系 统 (Geographical Information System，GIS) 是 一 种 采集 、 处 理 、 存 储 、 管 理 、 
分 析 、 输 出 地 理 空间 数据 及 其 属性 信息 的 计算 机 信息 系统 。 自 20 世纪 60 年 代 诞生 以 来 , GIS 
发 展 迅速 ， 应 用 也 日 趋 深化 和 广泛 ， 逐步 融入 信息 技术 (OT) 的 主流 ， 正 在 成 为 信息 产业 新 
的 增长 点 ， 是 发 展 潜力 巨大 的 地 理 信 息 产 业 的 主要 组 成 部 分 之 一 。 如 今 GIS 的 应 用 已 经 成 为 
我 国 国民 经 济 和 社会 信息 化 建设 的 亮点 ， 日 益 深入 到 各 个 专业 领域 和 百姓 日 常生 活 中 。 

通过 本 章 你 将 了 解 到 : 


11 地 理 信 息 系 统 及 其 发 展 趋势 
1.2 Web 服务 及 其 特点 

1.3 空间 信息 Web 服务 

14 GIS 的 Web 服务 规范 

1.5 GIS 的 Web 服务 实现 方式 
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1.1 地 理 信息 系统 及 其 发 展 趋势 


随 着 计算 机 技术 、 网 络 技术 、 数 据 库 技术 等 的 发 展 以 及 应 用 的 不 断 深化 ，GIS 技术 的 发 展 呈 现 
出 新 的 特点 和 趋势 ， 基 于 互联 网 的 Web GIS 就 是 其 中 之 一 。Web GIS 除了 应 用 于 传统 的 国土 、 资 
源 、 环 境 等 政府 管理 领域 外 ， 也 正在 促进 与 老百姓 生活 息息相关 的 车 载 导 航 、 移 动 位 置 服务 、 智 能 
交通 、 抢 险 救 灾 、 城 市 设施 管理 、 现 代 物 流 等 产业 的 迅速 发 展 。 


1.1.1 ”地 理 信息 系统 的 发 展 


在 一 定 意义 上 ， 地 理 信息 系统 是 计算 机 和 信息 系统 技术 在 地 理科 学 中 运用 发 展 的 产物 。 因 此 
地 理 信息 系统 不 仅 受 地 理 信 息 系统 的 应 用 和 需求 的 推动 ， 同 时 也 受 计 算 机 和 信息 科学 技术 的 推动 。 

20 世纪 60 年 代 末 世界 上 第 一 个 地 理 信 息 系 统一 一 加 拿 大 地 理 信息 系统 (CGIS) 诞生 ， 该 系 
统 主要 用 于 自然 资源 的 管理 和 规划 ; 随后 ， 美 国 哈佛 大 学 研制 出 SYMAP 系统 。 地 理 信息 系统 因 日 
益 引 起 各 国政 府 和 科学 家 的 高 度 重 视 而 迅速 发 展 。GIS 的 发 展 经 历 了 20 世纪 70 年 代 的 大 量 试验 开 
发 阶段 ，20 世纪 80 年 代 的 商业 开发 和 运作 阶段 以 及 20 世纪 90 年 代 以 用 户 为 主导 的 阶段 。 在 GIS 
发 展 初期 ， 只 有 地 理 研 究 人 员 、 地 质 调 查 局 、 土 地 森林 管理 部 门 、 人 口 调查 等 专业 部 门 和 研究 人 员 
对 其 感 兴趣 ， 而 目前 GIS 已 深入 到 政府 管理 、 城 市 规划 、 科 学 研究 、 资 源 开发 利用 、 测 绘 、 军 事 
等 广大 的 领域 。21 世纪 ， 地 理 信息 系统 已 远 远 不 是 地 理学 界 或 测绘 学 领域 的 概念 ， 而 将 成 为 人 们 
采集 、 管 理 、 分 析 空 间 数据 ， 共 享 全 球 信息 资源 ， 为 政府 管理 提供 决策 ， 科 学 研究 和 实施 可 持续 发 
展 战略 的 工具 和 手段 。 其 内 涵 从 狭义 的 地 理 信息 系统 (管理 地 理 信息 的 计算 机 系统 ) 到 更 广泛 的 空 
间 信 息 系统 (Spatial Information System) ， 并 逐渐 形成 地 球 信息 科学 〈GeoInformatics) 。 

从 20 世纪 60 年 代 以 来 ， 计 算 模 式 的 发 展 已 经 经 历 了 单机 计算 、 集 中 计算 到 C/S 模式 、B/S 模 
式 (三 层 结 构 模 式 ) 的 不 同 阶段 ， 正 逐渐 进入 以 Web 服务 (Web Services). 为 主要 特征 的 面向 服务 
的 计算 模式 。 

就 技术 层面 而 言 ， 地 理 信息 系统 的 发 展 也 经 历 了 三 代 ， 现 在 正在 向 第 四 代 过 渡 。 从 GIS 中 引 
入 的 网 络 技术 方面 来 看 ， 其 中 第 一 代 (0 世纪 60 年 代 一 80 年 代 中 期 ) 是 以 单机 单 用 户 为 平台 、 以 
系统 为 中 心 ; 第 二 代 Q0 世纪 so 年 代 中 期 一 90 年 代 中 期 ) 开始 引用 网 络 ， 实 现 了 多 机 多 用 户 的 
GIS; 第 三 代 (20 世纪 80 年 代 中 期 一 本 世纪 初 ) 引入 了 Intemet 技术 ， 开 始 向 以 数据 为 中 心 的 方向 
过 渡 ， 实 现 了 较 低 层次 的 〈 浏 览 型 或 简单 查询 型 ) 的 B/S 结构 。 

在 以 前 的 地 理 信息 系统 中 ， 基 本 上 以 系统 为 中 心 ， 不 同系 统 之 间 壁 又 比较 分 明 ， 数 据 共 享 与 
服务 共享 困难 。 在 三 十 多 年 的 时 间 里 ， 形 成 了 许多 GIS 软件 ， 他 们 在 不 同 的 环境 中 独自 发 展 ， 有 
自己 的 文化 背景 、 领域 背景 和 技术 背景 ,形成 了 自己 的 数据 模型 和 功能 组 织 结构 。 虽 然 在 功能 和 问 
题 描述 、 实 际 操作 上 差别 其 大， 加 上 内 部 空间 数据 组 织 不 同 或 者 互相 保密 ， 形 成 了 不 同 的 壁垒 ， 为 
信息 共享 增加 了 许多 困难 。 

由 于 Internet. 技术 和 Web 技术 的 成 熟 与 大 规模 普及 应 用 ,GIS 开始 面向 传统 行业 和 广大 民众 ， 
Web GIS 开始 出 现 和 发 展 ， 并 逐渐 成 为 GIS 应 用 的 一 种 重要 方式 。Web GIS 是 将 Web 技术 应 用 于 
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技术 应 用 于 GIS 开发 的 产物 ， 是 一 个 交互 式 的 、 分 布 式 的 、 动 态 的 地 理 信息 系统 ， 是 由 多 台 主 机 、 
多 个 数据 库 和 无 数 终端 ， 并 由 客户 机 与 服务 器 (HTTP 服务 器 及 应 用 服务 器 ) 相连 接 所 组 成 的 。 
Web GIS 中 ， 空 间 信息 应 用 主要 采取 的 是 B/S. (浏览 器 /服务 器 ) 方式 。 


1.1.2 ”传统 Web GIS 的 不 足 


网 络 技术 及 分 布 式 计算 技术 给 GIS 提供 了 更 好 的 支持 ， 同 时 也 提出 了 更 高 的 要 求 。 随 着 网 络 
信息 基础 设施 和 技术 的 不 断 发 展 与 完善 ， 分 布 式 地 理 信息 服务 正成 为 人 们 获取 地 理 信息 的 主要 手 
段 。 与 传统 方式 相 比 ， 分 布 式 地 理 信息 服务 具有 更 广泛 的 访问 范围 、 平 台独 立 性 、 低 系统 成 本 、 更 
简单 的 操作 等 优点 ， 是 今后 GIS 发 展 的 重要 方向 。 


(1) Web GIS 的 主要 功能 和 应 用 是 用 于 地 图 的 发 布 ， 这 类 系统 基本 上 是 浏览 型 或 功能 相对 简 
单 的 查询 型 系统 。 即 使 有 少量 的 对 空间 数据 的 操纵 ,但 这 种 操纵 的 功能 很 弱 , 无 法 进行 复杂 的 一 体 
化 操作 ， 离 全 面 的 互 操作 及 分 布 式 的 地 理 信息 系统 的 要 求 还 很 遥远 。 

(2) Web GIS 中 主要 是 服务 端 与 客户 端的 通讯 ， 由 于 服务 端 与 客户 端的 地 位 没有 形成 对 等 的 
实体 ， 因 而 难于 建立 分 布 式 的 地 理 信息 系统 。 

(G) Web GIS 中 传递 的 数据 主要 是 以 矢量 形式 表达 的 少量 地 图 数据 或 者 是 以 栅 格 形式 表达 的 
地 图 ， 这 样 的 地 图 数据 ， 在 各 个 应 用 系统 中 的 格式 不 统一 ， 语 义 也 不 统一 。 由 于 缺乏 统一 的 标准 ， 
数据 的 共享 难于 实现 。 

(4) Web GIS 中 实现 的 操作 ， 在 各 个 系统 中 没有 统一 的 描述 的 机 制 (虽然 也 有 一 些 系 统制 定 
了 一 定 的 查询 语言 如 GeoSQL， 但 这 不 是 所 有 的 系统 都 采用 的 ) ， 也 没有 对 这 些 操作 和 服务 提供 注 
册 和 发 现 的 机 制 ， 因 此 服务 的 共享 难以 实现 。 

(5) Web GIS 还 没有 形成 一 套 有 效 的 集成 机 制 。 新 一 代 的 GIS 要 求 有 效 的 分 布 式 空间 数据 
管理 和 计算 ， 包 括 : 多 用 户 同步 空间 数据 操作 与 处 理 机 制 ; 数据 、 服 务 代理 和 多 级 B/S 体系 结构 ; 
异种 GIS 系统 互 连 与 互 操作 ; 空间 数据 分 布 式 存储 与 数据 安全 ; 空间 数据 高 效 压缩 与 解压 缩 ; 同 
时 要 求 强大 的 应 用 集成 能 力 ， 包 括 有 效 的 遥感 、 地 理 信息 系统 、 全 球 定位 系统 集成 ， 强大 的 应 用 模 
型 支持 能 力 ; GIS 与 MIS (管理 信息 系统 ) 、 特 别 是 ERP (企业 资源 计划 〉 的 有 机 集成 ，GIS 与 
OA 办 公 自 动 化 ) 的 有 机 集成 ，GIS 与 CAD (计算 机 辅助 设计 ) 的 有 机 集成 ，GIS 与 DCS O 
策 支 持 系统 ) 的 有 机 集成 ， 有 一 定 实时 能 力 、 微 型 化 、 嵌 入 式 GIS 与 各 类 设备 的 集成 等 等 。 

从 以 上 所 列举 的 来 看 ，GIS 中 大 量 的 数据 不 断 积 累 、 各 种 层次 的 软件 也 越 来 越 多 ，Web 技术 


的 发 展 给 GIS 提出 了 更 高 的 要 求 ，GIS 的 分 布 式 、 可 互 操作 性 显得 越 来 越 重要 ， 这 恰恰 是 当前 
Web GIS 要 着 重 解 决 的 问题 ， 这 也 是 新 一 代 〈 即 第 四 代 ) GIS 的 一 个 重要 发 展 方向 。 


1.1.3 Web 服务 成 为 解决 方案 


随 着 Web 技术 、 组 件 技术 、 分 布 式 系统 等 技术 的 发 展 ， 在 近 几 年 出 现 了 Web 服务 技术 ， 并 
逐渐 引起 了 人 们 的 注意 ， 并 成 为 分 布 式 异 构 GIS 进行 互 操作 集成 的 首选 技术 。 
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在 Web 应 用 的 不 断 发 展 过 程 中 ， 人 们 发 现在 Web 应 用 和 传统 桌面 应 用 (比如 企业 内 部 管理 
系统 、 办 公 自 动 化 系统 等 ) 之 间 存 在 着 连接 的 鸿沟 ， 人 们 不 得 不 重复 地 将 数据 在 Web 应 用 和 传统 
桌面 应 用 之 间 迁 移 ， 这 成 为 了 阻碍 Web 应 用 进入 主流 工作 流 的 一 个 巨大 障碍 。 

从 1998 年 开始 发 展 的 XML 技术 及 其 相关 技术 已 证 明 可 以 解决 这 个 问题 。 而 近期 开始 蓬勃 发 
展 的 Web 服务 技术 则 正 是 基于 XML 技术 的 针对 这 一 问题 的 最 佳 解 决 方案 。Web 服务 (Web 
Services). 的 主要 目标 就 是 在 现 有 的 各 种 异 构 平 台 的 基础 上 构筑 一 个 通用 的 与 平台 无 关 、 语 言 无 关 
的 技术 层 ， 各 种 不 同 平 台 之 上 的 应 用 依靠 这 个 技术 层 来 实施 彼此 的 连接 和 集成 。Web 服务 与 传统 
Web 应 用 技术 的 差异 在 于 : 传统 Web 应 用 技术 解决 的 问题 是 如 何 让 人 来 使 用 Web 应 用 所 提供 的 
服务 ， 而 Web 服务 则 要 解决 如 何 让 计算 机 系统 来 使 用 Web. 应 用 所 提供 的 服务 。 

将 Web 服务 应 用 于 GIS, 则 可 以 使 传统 的 地 理 信息 系 统 由 独立 的 C/S 结构 或 B/S 结构 , 实现 
到 基于 Web 服务 体系 的 GIS 的 跨 跃 ( 如 图 1.1 所 示 ) 。 


WebServices 


数据 与 系统 紧密 Bonn 


相连 


C/S 结构 


分 布 式 互 操作 数据 
/服务 集成 


各 种 平台 、 设 备 


中 间 件 技 件 
空间 数据 库 


orkStation 


图 1.1 GIS 的 网 络 化 的 发 展 趋势 
1.2 Web 服务 及 其 特点 


1.2.1 Web 服务 概述 


W3C (Word Wide Web Consortium) 组 织 对 Web 服务 的 定义 如 下 : 


Web 服务 是 一 个 由 URI (Uniform Resource Identifer ) 指定 的 软件 组 件 或 应 用 ， 它 的 接口 和 绑 
定 可 以 用 标准 的 XML 进行 描述 并 支持 与 其 他 软件 和 组 件 进行 交互 。 


在 实现 分 布 式 、 可 互 操作 及 应 用 系统 集成 方面 ，Web 服务 技术 成 为 新 一 代 Web 技术 。Web 
服务 从 本 质 上 来 说 是 一 种 基于 对 象 /组 件 模 型 的 分 布 式 计算 技术 。Web 服务 的 基础 是 XML (可 扩展 
标记 语言 ) 及 基于 其 上 的 SOAP (Simple Object Access Protocol， 简 单 对 象 访问 协议 ) ， 其 基本 结 
构 是 : 客户 端 和 服务 端 之 间 把 请 求 和 数据 结果 以 XML 的 形式 进行 SOAP 包装 ， 以 HITP 等 形式 
进行 传送 ， 从 而 实现 相应 交互 。Web 服务 技术 的 一 大 特点 是 ， 通 过 使 用 Web 服务 定义 接口 ， 可 以 
掩盖 各 种 不 同 实现 之 间 的 区 别 以 及 各 相互 联结 的 系统 之 间 的 异 构 性 。 在 Web 服务 技术 中 ， 整 个 网 
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络 成 为 一 个 开放 式 的 组 件 平 台 ， 通 过 组 合 不 同 的 Web 组件， 应 用 程序 很 容易 就 能 得 到 近乎 无 限 的 
扩展 ， 从 而 满足 用 户 的 各 种 功能 需求 。 

也 就 是 说 , Web 服务 就 是 由 服务 组 件 通过 某 些 网 络 协议 提供 的 远程 调用 接口 。Web Services 并 
不 是 一 种 新 的 服务 端 组 件 ， 而 是 原来 的 服务 端 组 件 提供 了 一 种 新 的 通过 SOAP 协议 来 调用 的 统一 
接口 。 


1.22 Web 服务 的 特点 


Web 服务 重要 之 处 在 于 ，Web 服务 实现 平台 的 细节 和 业务 调用 程序 无 关 。Web Services 可 以 
用 其 声明 的 API 和 调用 机 制 ( 网 络 、 数 据 编码 模式 等 ) 进 行 访问 。 这 种 方式 类 似 于 浏览 器 和 Web 应 
用 服务 器 之 间 的 关系 ，Web 服务 器 不 必 关 心 使 用 它 是 哪 类 客户 一 一 可 以 是 不 同 种 类 的 浏览 器 或 者 
甚至 是 不 使 用 浏览 器 的 客户 。 这 种 方式 使 得 Web 服务 可 以 形成 松散 耦合 的 组 件 系 统 。 

对 于 Web 服务 的 外 部 使 用 者 而 言 ，Web 服务 是 一 种 部 署 在 Web 上 的 对 象 组 件 ， 它 具备 以 下 
特征 : 

(1) 良好 的 封装 性 

Web 服务 是 部 署 于 网 络 上 的 对 象 ， 具备 对 象 组 件 自然 具有 的 良好 封装 性 。Web Service 在 对 象 
的 实现 者 (服务 者 ) 与 对 象 的 调用 者 〈 请 求 者 ) 之 间 是 一 组 调用 接口 。 实 现 者 与 服务 者 相互 分 开 ， 
一 个 服务 接口 可 以 有 多 个 请 求 者 , 一 个 请 求 者 可 以 调用 多 个 实现 相同 接口 的 服务 , 这 种 机 制 不 仅 使 
对 象 组 件 具 有 良好 的 封装 性 ， 提 高 了 软件 的 产生 能 力 和 集成 能 力 。 


(20 分 布 性 

Web 服务 实现 者 与 调用 者 可 以 分 布 在 网 络 上 的 各 处 ， 可 以 在 同一 进程 中 ， 可 以 位 于 不 同 的 机 
器 中 ,也 可 以 位 于 地 理 位 置 完全 不 同 的 网 络 中 的 不 同 机 器 中 。 对 于 一 个 应 用 系统 而 言 ， 需 要 的 多 个 
服务 也 可 以 分 布 于 网 络 上 不 同 的 环境 中 ， 这 样 ， 一 个 任务 可 以 实现 网 络 的 分 布 性 。 


(3) 使 用 标准 协议 

与 一 般 对 象 相 比 而 言 ，Web 服务 的 接口 规范 更 加 规范 并 且 易 于 机 器 理解 。 首 先 ,作为 Web 服 
务 的 对 象 接口 所 提供 的 功能 应 当 使 用 标准 的 描述 语言 来 描述 (如 WSDL) ; 其次， 由 标准 描述 语 
言 描述 的 服务 接口 应 当 能 够 被 发 现 的， 因此 这 一 描述 文档 需要 被 存储 在 私有 的 或 公共 的 注册 库 中 。 
同时 ， 使 用 标准 描述 语言 描述 的 使 用 协约 将 不 仅仅 是 服务 界面 ， 它 将 被 延伸 到 Web 服务 的 聚合 、 
跨 Web 服务 的 事务 、 工 作 流 等 ， 而 这 些 又 都 需要 服务 质量 的 保障 。 另 外 ， 对 于 松散 耦合 的 系统 环 
境 安全 机 制 非常 重要 ， 因 此 需要 对 诸如 授权 认证 、 数 据 完整 性 、 事 务 处 理 的 不 可 抵赖 性 等 用 规范 方 
法 来 描述 和 交换 。 这 些 方面 都 已 经 有 了 或 者 正在 制定 一 系列 的 公共 协议 ， 事 实 上 ，Web 服务 的 协 
议 是 当前 计算 机 领域 中 最 受 人 关注 的 话题 。 


(D 跨 平台 、 跨 语言 

由 于 Web Services 是 架设 在 一 系列 通用 的 协议 之 上 , 其 中 重要 的 协议 是 基于 XML 的 , 这 就 决 
定 了 它 与 传统 的 系统 集成 技术 不 同 ， 它 可 以 运行 于 各 种 平台 ， 包 括 典型 的 Windows 和 UNIX, E) 
时 它 的 技术 又 是 跨越 编程 语言 界线 的 ， 无 论 是 企业 中 广泛 使 用 的 Java， 还 是 桌面 应 用 的 Co. CH, 
Visual Basic， 都 可 以 实现 Web 服务 ， 并 且 调 用 者 与 实现 者 可 以 采用 不 同 的 编程 语言 。 
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(5) 可 集成 能 力 

由 于 Web 服务 采取 简单 的 、 易 理解 的 标准 Web 协议 作为 组 件 界面 描述 和 协同 描述 规范 ， 完 
全 屏蔽 了 不 同 软件 平台 的 差异 , 无 论 是 CORBA、DCOM 还 是 RMI 都 可 以 通过 这 一 种 标准 协议 进 
行 互 操 作 ， 从 而 实现 在 当前 环境 下 各 种 技术 的 集成 。 在 这 个 意义 上 ， 这 种 集成 可 以 是 “ 非 紧密 的 ” 
集成 ， 是 易于 实现 的 集成 。 


从 以 上 所 述 可 以 看 出 ，Web 服务 成 为 分 布 式 异 构 系统 集成 的 极 佳 手段 。 


1.3 空间 信息 Web 服务 


EMA GIS 系统 基础 之 上 ， 对 已 有 的 数据 及 功能 模块 进行 重新 解析 、 包 装 及 组 合 ， 可 以 实现 
空间 信息 Web 服务 。 其 基本 要 素 是 各 个 空间 信息 的 Web 服务 , 服务 间 数 据 通信 采用 XML 作为 数 
据 流 的 格式 ， 控 制 通信 采用 Web 服务 调用 的 方式 。 

分 布 性 与 互 操作 是 地 理 信息 系统 的 必然 要 求 , 空间 信息 Web 服务 可 以 说 正 是 顺应 了 这 种 要 求 。 


1.8.0 从 数据 共享 的 角度 看 空间 信息 Web 服务 


空间 数据 共享 一 直 是 GIS 发 展 的 瓶颈 。 地 理 空间 数据 是 研究 地 球形 成 演化 、 探 讨 人 类 生存 环 
境 \ 减 轻 自然 灾害 ,合理 开发 资源 和 促进 社会 可 持续 发 展 的 重要 科学 依据 , 随 着 网 络 技术 及 Web GIS 
的 飞速 发 展 和 应 用 , 更 加 人 迫切 要 求 社会 各 部 门 能 够 共享 地 理 空间 数据 以 及 与 之 相关 的 资料 , 实现 地 
理 空间 信息 的 全 球 共享 。 地 理 空间 信息 共享 的 重要 性 主要 体现 在 : 


1) 为 决策 全 球 化 问题 同时 提供 大 量 的 科学 地 理 数据 。 

2) 地 理 信息 系统 (GIS) 发 展 的 强烈 要 求 。 

3) 为 使 用 空间 信息 的 社会 各 部 门 节省 大 量 的 人 才 、 时 间 和 金钱 。 
4) 便于 实现 空间 信息 的 规范 化 和 标准 化 。 

5) 可 以 加 强 空间 信息 的 高 效 管理 、 维 护 、 重 复 利用 和 有 效 增值 。 
6) 为 数字 地 球 建设 葛 定 基础 。 


空间 信息 共享 是 指使 得 查询 、 浏 览 、 获 取 、 交 换 、 使 用 和 再 加 工地 球 上 与 人 类 生存 直接 或 间接 
相关 的 信息 能 够 做 到 方便 、 快 捷 、 准 确 、 安 全 和 全 面 ， 包 括 对 部 分 信息 处 理 资 源 的 自由 使 用 。 空 间 
信息 共享 强调 空间 数据 集 之 间 的 相互 透明 访问 和 信息 用 户 对 数据 集 的 透明 访问 与 使 用 , 注重 从 空间 
信息 的 语义 层次 数据 模型 层次 和 数据 结构 层次 消除 空间 信息 描述 方法 上 的 差异 性 以 及 表示 方法 上 
的 差异 性 ， 对 空间 信息 给 出 统一 的 描述 和 表示 ， 达 到 空间 信息 本 质 上 和 形式 上 的 共享 。 

空间 信息 共享 活动 涉及 了 三 个 主要 概念 : 空间 信息 资源 、 空 间 信息 的 获取 与 处 理 和 空间 信息 应 
用 。 而 这 样 也 就 出 现 了 三 种 不 同 的 角色 : 空间 信息 提供 者 、 空 间 信息 处 理 软件 和 提供 者 一 一 就 是 通 
常 所 谓 的 GIS 以 及 用 户 。 

空间 信息 共享 要 解决 可 达 性 、 互 操作 性 和 易 用 性 。 


O 可 达 性 是 指 用 户 能 存 取 到 数据 。 通 过 空间 信息 Web 服务 ， 用 户 可 以 通过 其 中 提供 的 数据 
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服务 ， 来 查找 、 获 取 用 户 感 兴趣 的 数据 ， 这 种 数据 可 以 分 布 于 网 络 上 ， 并 由 不 同 的 服务 
商 来 提供 不 同 区 域 、 不 同 专题 、 不 同 质量 的 数据 。 

O 互 操作 性 是 指 不 同 的 GIS 之 间 能 互相 操作 、 对 数据 能 进行 相同 的 理解 。GIS 互 操作 的 关 
键 就 是 想 解决 空间 信息 异 构 问 题 。 而 信息 具有 语法 和 语义 ， 可 以 分 层次 讨论 信息 异 构 问 
题 。 因 此 在 Intemet 环境 中 的 空间 信息 共享 ， 通 过 空间 信息 Web 服务 ， 可 以 进行 语法 及 
语义 差别 的 消除 工作 。 在 消除 空间 信息 资源 的 语法 差异 方面 ， 通 过 Web Services， 可 以 在 
数据 的 请 求 者 与 服务 者 之 间 用 统一 的 数据 格式 ， 这 种 数据 格式 包括 GML 在 内 ， 它 们 已 
逐渐 形成 标准 ， 并 在 Web 服务 中 使 用 。 在 消除 空间 信息 资源 的 语义 差异 方面 ， 语 义 Web 
等 方面 的 进展 也 可 以 对 此 有 所 帮助 。 


在 数据 共享 所 采用 的 技术 方面 ， 包 括 数据 格式 转换 ， 通 过 API 直接 读 取 ， 是 比较 低层 的 方式 ; 
基于 DBMS 的 集成 ， 则 可 以 使 数据 更 统一 ， 具 有 一 定 的 互 操作 性 ; 基于 Web Services 进行 集成 的 
系统 中 ， 数 据 有 统一 的 Schema 描述 ， 数 据 之 间 在 进行 接口 时 有 统一 的 协议 和 标准 ， 可 以 有 效 地 实 
现 数据 的 共享 。 如 图 1.2 所 示 。 


基于 Web Services 
集成 


基于 DBMS 集成 


1 
通过 API 1 
直接 读 取 | 

1 
1 


1 
[| 
! 数据 格式 转换 


图 1.2 数据 共享 方式 


1.3.2 ”从 软件 复 用 的 角度 看 空间 信息 Web 服务 


GIS 技术 经 过 长 期 的 发 展 ， 特 别 是 近年 来 的 长 足 进步 ， 已 经 积累 了 大 量 的 基础 软件 及 应 用 软 
件 ， 这 些 软件 功能 各 不 相同 、 编 程 方法 不 同 、 编 程 接口 不 同 、 用 户 界 面 也 不 相同 ， 在 新 的 网 络 日 益 
发 展 、 软 件 技术 飞速 进步 的 今天 ， 如何 有 效 地 发 挥 这 些 软 件 的 功能 ， 充 分 利用 已 有 的 软件 来 或 软件 
构件 ， 实 现 功 能 更 强 的 软件 或 快速 实现 一 个 应 用 系统 ， 也 是 摆 在 GIS 软 存 在 大 量 的 可 复 用 构件 是 
有 效 复 用 的 基本 前 提 ; 而 有 效 地 管理 大 量 构件 , 提供 方便 的 构件 存储 、 构件 检索 和 构件 提取 等 功能 ， 
则 是 成 功 复 用 的 必要 保证 。Web 服务 系统 则 为 这 种 复 用 和 管理 提供 了 一 种 技术 支撑 。 

首先 ， 将 现 有 的 GIS 系统 中 的 功能 改造 成 Web 服务 是 可 行 的 。 由 于 Web 服务 采用 的 技术 基 
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础 是 XML， 它 是 一 种 规范 化 的 文本 ， 易 于 被 各 种 编程 语言 进行 处 理 ， 这 使 得 现 有 的 GIS 系统 中 的 
功能 ， 进 行 分 解 、 重 组 、 规 范 化 ， 从 而 提供 Web 服务 接口 是 可 以 实施 的 。 

其 次 ，Web 服务 中 的 对 象 ， 实 际 是 网 络 上 分 布 的 对 象 。 这 些 对 象 不 论 其 内 部 如 何 实 现 ， 但 这 
些 对 象 之 间 是 靠 通用 的 接口 来 进行 通信 的 , 这 些 接口 遵守 各 种 层次 的 协议 , 如 XML、 SOAP, WSDL 
等 ， 对 于 空间 信息 Web 服务 中 的 服务 ， 还 有 与 空间 信息 处 理 相 关 的 协议 ， 如 WES, WES 等 等 。 
一 个 系统 可 以 方便 地 调用 远程 对 象 , 而 不 论 这 种 对 象 是 在 什么 平台 上 , 也 不 论 这 种 对 象 是 用 什么 编 
程 技 术 来 实现 的 ， 这 样 ， 通 过 Web 服务 的 对 象 复 用 实现 了 更 高 层次 的 对 象 复 用 。 

另外 ，Web 服务 是 服务 的 松散 集合 ， 可 以 方便 地 发 布 ， 并 可 以 通过 程序 自动 或 人 工 进 地 进行 
查找 和 调用 ， 这 就 给 利用 已 有 的 Web 服务 带 来 了 方便 。 例 如 ， 可 以 将 现 有 的 多 个 不 同 供应 商 提供 
的 地 图 显示 服务 集合 起 来 ， 再 形成 一 个 新 的 、 面 向 专题 的 地 图 服务 。 


1.8.9 ”从 系统 集成 的 角度 看 空间 信息 Web 服务 


Web 服务 技术 在 一 定 意义 上 是 一 种 系统 集成 的 技术 。Web 服务 用 于 GIS 是 一 种 更 好 的 进行 
GIS 系统 集成 的 技术 。 
GIS 系统 的 集成 技术 经 历 了 以 下 的 一 个 发 展 过 程 。 


(1) 基于 对 象 技术 的 RPC 方法 

多 年 以 来 ， 应 用 程序 分 布 式 集成 计算 方法 的 演化 基本 上 都 基于 远 端 过 程 调用 (RPC, Remote 
Procedure Call) 机 制 。RPC 是 指 应 用 程序 对 运行 在 远 端 计算 机 上 的 代码 进行 功能 调用 。 为 实现 该 
调用 的 请 求 , 在 相互 协作 的 计算 机 之 间 , 需要 使 用 特定 的 协议 支持 来 对 信息 数据 进行 打包 、 发 送 和 
接收 。 

目前 基本 上 每 种 主要 的 对 象 技术 均 有 其 自己 的 RPC HER. Microsoft 组 件 对 象 模型 (COM) 
使 用 DCOM/COM+，CORBA 使 用 IOP，Java 使 用 RMI。 这 种 “分 布 式 对 象 ”为 标志 的 集成 分 布 
式 系统 ， 应 用 于 集成 更 广泛 的 分 布 式 系统 时 ， 具 有 其 很 大 的 不 足 。 由 于 这 些 应 用 程序 接口 需要 “ 严 
格 匹 配 ”， 并 与 目标 系统 的 专用 技术 密切 相关 ， 所 以 其 连接 非常 脆弱 ， 很 难 实现 真正 的 跨 平 台 、 异 
构 系 统 的 集成 。 由 于 这 些 相 互 关联 的 组 件 可 能 各 不 相同 ， 所 以 开发 和 维护 的 费用 非常 高 。 由 于 在 等 
待 远 端 所 访问 资源 的 响应 时 ， 对 组 件 进行 的 同步 调用 经 常 “ 阻 塞 ”， 所 以 其 可 扩展 性 也 存在 固有 的 
缺陷 。 


(2) 基于 消息 中 间 件 技术 的 RPC 方法 

基于 消息 中 间 件 技术 引入 了 关联 的 方法 , 以 便 使 用 消息 传送 技术 集成 更 大 范围 地 域 中 的 分 布 式 
系统 ,改进 了 对 象 集成 技术 可 扩展 性 和 可 管理 性 。 由 于 这 样 通常 不 会 阻塞 应 用 程序 的 调用 ,应 用 程 
序 可 以 “发 送 并 忘记 ”信息 ， 从 而 使 操作 更 有 弹性 和 可 扩展 性 。Microsoft、IBM、BEA 等 公司 都 
提供 消息 队列 与 事务 处 理 中 间 件 产品 ， 支 持 分 布 式 应 用 系统 的 集成 。 

基于 “消息 中 间 件 ”的 集成 技术 的 一 个 主要 限制 就 是 它 的 开放 性 。 首 先 ， 即 使 系统 最 初 可 以 接 
受 开放 数据 格式 , 它们 仍然 基于 专用 程序 很 高 的 技术 , 并 使 用 专用 的 接口 和 专用 的 内 部 数据 表示 方 
ik; 其 次 , 购买 这 些 技 术 、 集 成 和 后 续 维 护 昂贵 ， 且 这 些 技术 通常 需要 在 应 用 程序 联接 的 两 端 同 时 
运行 特定 的 软件 或 各 有 一 份 客户 许可 协议 , 这 样 增加 了 成 本 、 消 耗 时 间 并 增加 了 集成 的 复杂 性 , f 


成 的 范围 也 受到 限制 。 故 需要 一 种 开放 的 系统 集成 技术 ， 使 用 符合 工业 标准 的 传输 协议 、 过 程 调用 
和 数据 表示 方法 ， 支 持平 台 分 布 式 系统 的 低 成 本 集成 与 互 操 作 。 


(3) Web 服务 方法 

Web 服务 方法 最 早起 源 于 XML-RPC 技术 。 在 1998 年 早期 ，Userland、DevelopMentor 与 
Microsoft 一 起 发 布 了 XML-RPC (http://www.xmlrpc.com) 。XML-RPC 提供 了 一 种 简单 的 机 制 ， 
使 处 于 不 同 环境 下 的 应 用 之 间 ， 可 以 通过 Internet 来 进行 远程 过 程 调用 。 它 采用 XML 作为 编码 标 
HE, HTTP 为 传输 协议 ,XML-RPC 通 过 HTTP 请 求 向 RPC 服务器 提交 请 求 , 通过 HITP 响 应 Response 
获得 RPC 的 调用 结果 。 这 种 XML-RPC 技术 突出 地 强调 了 XML 和 HTTP 的 作用 ， 使 用 应 用 的 集 
成 可 以 跨 平 台地 进行 。 

后 来 ，IBM、Microsoft、SAP 等 公司 一 道 在 此 基础 上 逐步 提出 了 Web Services 的 概念 ， 并 制 
定 了 一 系列 服务 调用 、 发 布 、 集 成 的 协议 ， 使 Web Services 成 为 新 一 代 的 系统 集成 方法 。 

空间 信息 Web 服务 就 是 将 这 种 新 的 技术 应 用 于 地 理 信 息 系统 ， 解 决 地 理 信 息 系统 中 的 多 源 、 
异 构 、 分 布 系统 的 集成 问题 。 


1.3.4 空间 信息 Web 服务 的 优势 


与 普通 Web 服务 一 样 ， 空 间 信息 Web 服务 也 具有 不 少 的 优势 ， 如 : 
分 布 

可 伸缩 性 

功能 全 面 

系统 可 维护 性 好 

软件 集成 费用 低 

使 用 工业 标准 ， 所 以 可 以 方便 地 与 其 他 软件 及 企业 合作 


具体 来 说 ， 空 间 信 息 Web 服务 具有 以 下 一 些 特色 : 


(1) 能 较 好 地 处 理 数据 的 共享 。 它 可 以 避免 与 具体 数据 格式 的 紧密 绑 定 。 不 同 的 GIS 可 以 选 
择 不 同 的 后 台数 据 库 ， 同 时 ，Web Services 不 但 允许 客户 端 对 服务 端的 数据 进行 访问 ， 还 允许 服务 
端 对 服务 端的 数据 共享 服务 。 一 个 GIS 可 以 对 自己 的 数据 库 (如 RDMS、SDE 或 数据 文件 ) 进行 
优化 ， 同 时 存 取 其 他 格式 的 数据 ， 从 而 产生 数据 、 地 图 或 空间 计算 的 服务 ， 为 更 广大 的 客户 端 提供 
一 个 统一 的 数据 服务 环境 。 

(2) 能 建立 一 个 标准 的 空间 计算 的 基本 环境 框架 。 由 于 Web Services 分 布 于 网 络 上 的 各 处 节 
点 ， 包 括 服务 器 、 工 作 站 、 桌 面 客户 端 ， 以 及 手机 、PDA 等 便携 产品 。Web Services 的 标准 使 得 
这 些 设备 可 以 统一 起 来 构成 一 个 更 广 的 分 布 计算 环境 。 这 种 计算 环境 不 仅仅 是 为 Intemet， 它 可 以 
为 各 种 分 布 式 计算 提供 有 力 的 支持 。 

G) 能 为 各 种 开放 式 网 络 提供 一 个 融合 的 计算 环境 。 通 过 Web Services， 各 种 计算 节点 的 三 
种 角色 ， 即 客户 、 服 务 和 代理 ， 它 们 可 以 们 位 于 Intemet、 无 线 网 络 或 者 是 局 域 网 中 。 客 户 端 可 以 
是 普通 应 用 程序 ， 也 可 以 是 Web 浏览 器 ，Java Applet， 也 可 以 是 移动 设备 。 客 户 端 向 各 个 服务 提 
出 请 求 并 获得 结果 ; 服务 则 一 直 准备 着 提供 服务 ; 代理 则 为 服务 的 发 布 和 查找 提供 支持 。 这 三 种 角 
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色相 互 配 合 ， 形 成 了 一 个 融合 的 计算 环境 。 

(4) 能 方便 地 集成 。 如 上 文 所 述 ，Web Services 之 间 可 以 互相 集成 ， 这 不 仅 使 空间 信息 的 服 
务 集成 成 为 可 能 ， 同 时 也 为 GeoWebServices 与 办 公 软 件 、 企 业 工 作 流 、 电 子 商 务 、 电 子 政务 方便 
地 集成 。 例 如 政府 部 分 可 以 将 有 关 林 业 、 农 业 、 水 利 、 环 境 监 测 等 部 分 的 地 理 信息 集成 到 电子 办 公 
中 去 ， 并 作为 决策 的 依据 。 


由 此 看 来 ，Web Services 是 实现 新 一 代 GIS (第 四 代 GIS) 的 重要 手段 。 第 四 代 GIS 的 目标 
是 由 以 系统 为 中 心 向 以 数据 为 中 心 ， 实 现 空间 数据 共享 与 服务 的 转变 ， 成 为 OS、DBMS 之 上 的 主 
要 应 用 集成 平台 ，Web Services 正 是 这 种 平台 实现 的 一 种 基本 方式 。 同 时 ，Web Services 在 GIS 中 
的 应 用 ， 同 它 在 其 他 领域 中 的 应 用 一 样 ， 将 是 革命 性 的 变化 ， 由 于 Web Services 可 以 集成 现 有 的 
各 个 平台 上 的 GIS 数据 与 服务 ， 同 时 ， 还 可 以 方便 地 与 OA、MIS、 电 子 商务 、 电 子 政务 、 公 众 服 
务 系统 等 进行 集成 ， 实 现 社会 化 GIS、 公 众 GIS 等 。 

可 以 说 ，Web Services 将 是 实现 空间 信息 基础 设施 的 基本 方式 ， 它 会 在 数字 城市 、 数 字 地 球 等 
领域 中 发 挥 重 要 作用 。 


1.4 GIS 的 Web 服务 规范 


在 GIS 分 布 式 、 互 操作 方面 ， 一些 组 织 (如 OGC, UCGIS $) 正在 制定 相应 标准 和 进行 一 
些 实验 项 目 ， 其 中 OGC 开放 地 理 信息 系统 协会 ) 在 空间 信息 Web Services 方面 继续 制定 了 一 系 
列 规范 。 

OGC 一 个 是 由 多 个 企业 、 大 学 、 政 府 部 门 组 成 的 非 莉 利 性 组 织 ， 最 初 目的 是 想 提供 一 套 综合 
的 开放 性 接口 规范 ， 以 便 开发 商 可 以 根据 这 些 规范 来 编写 互 操 作 组 件 ， 以 满足 GIS 互 操作 的 需求 ， 
后 来 就 成 为 一 个 专门 发 展 OpenGIS 规范 的 机 构 , 以 制订 和 推进 开放 的 空间 数据 互 操作 规范 为 目标 。 

对 于 Web 服务 在 空间 信息 领域 的 应 用 , OGC 表现 了 极 大 的 关注 ,2001 年 3 H, OGC 发 出 OGC 
Web Services Initiative Phase 1 的 技术 请 求 ， 启 动 了 OWS 标准 的 开发 进程 。 


在 OGC 制定 的 规范 中 ,从 规范 的 名 称 中 也 可 以 看 出 向 Web 服务 的 发 展 趋势 , 从 OGC01-065: 
Web Feature Server Implementation Specification 到 OGC02-058: Web Feature Service Implementation 
Specification〈 如 图 1.3 所 示 ) ， 原 先 用 Server， 后 来 用 Service， 这 实际 上 体现 了 从 传统 的 Web GIS 
向 Web 服务 观念 的 转变 。 
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图 13 传统 Web GIS 与 基于 Web 服务 的 GIS 的 对 比 
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1.4.1 OWS 服务 体系 


在 OWS 服务 体系 中 ， 主 要 的 部 分 包括 : 


O 地理 数据 服务 (Data Service). 一 一 提供 对 空间 数据 的 服务 ， 主 要 有 WFS (Web Feature 
Service, KEIRA) ，WCS ( Web Coverage Service， 栅 格 数据 服务 ) 。 地 理 数 据 服 
务 返 回 的 结果 通常 是 带 有 空间 参照 系 的 数据 。 

口 ” 地 图 描绘 服务 ( Portrayal Service) 一 一 提供 对 空间 数据 的 描绘 主要 有 WMS (Web Map 
Service， 地 图 服务 ) ， 其 中 地 图 可 以 由 多 个 图 层 组 合 起 来 ， 每 个 地 图 可 以 用 SLD (Styled 
Layer Descriptor) 来 对 地 图 进行 描述 。 地 图 服务 的 返回 结果 通常 是 矢量 图 形 或 栅 格 图 形 。 

O 过程 处 理 服务 (Processing Service ) 提供 地 理 数据 的 查找 、 索 引 等 服务 ， 主 要 有 
Geocoder ( 地 学 编码 服务 ) 、Gazetteer ( 地 名 索引 服务 ) 、Coordinate Transfer Service ( 坐 
标 转换 服务 等 ) 。 

O ”发 布 注册 服务 (Registry ) 提供 对 各 种 服务 的 注册 服务 ， 以 便于 服务 的 发 现 。 其 中 包 

括 数 据 类 型 、 数 据 实例 、 服 务 类 型 、 服 务实 例 的 注册 服务 。 注 册 服 务 提供 了 各 个 注册 项 

的 登记 、 更 新 及 查找 服务 。 

O ”客户 端 应 用 (Client Application) 一 一 即 客户 端的 基本 应 用 ， 如 地 图 的 显示 、 地 图 浏览 以 
及 其 他 一 些 增值 服务 。 


142 ”空间 信息 Web 服务 的 角色 与 功能 划分 


空间 信息 Web 服务 是 一 种 Web 分 布 式 计算 的 框架 。 根 据 在 Web 服务 中 的 作用 ， 可 以 划分 为 
三 种 基本 的 角色 : 服务 的 提供 者 、 服 务 的 请 求 者 以 及 服务 的 中 介 ， 如 图 1.4 所 示 。 
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图 服务 定义 
A 类 型 定义 


e 服务 实例 


图 1.4 服务 中 的 角色 的 划分 


根据 这 三 种 角色 ， 将 OGC 定义 的 OWS 中 的 相应 规范 进行 划分 ， 则 如 图 1.5 所 示 : 


idu ru zm] — 
ploitation inageme 
Client Client 


Multi-source, Integrated Application Client 


SI9 gam 


Data Ez wn Portrayal Processing 
Services Services Services 


EE = OGC/P Interface 
图 1.5 基于 Web Services 的 GIS 系统 的 体系 结构 


另外 ， 对 于 服务 与 客户 端的 关系 ， 如 图 1.6 所 示 。 
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OpenGIS® 
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Service 
Framework 


图 1.6 OpenGIS 框架 下 的 应 用 客户 和 服务 器 


OpenGIS 服务 框架 里 的 应 用 客户 又 称 为 客户 端 应 用 程序 (Client-side Applications) ， 它 应 该 有 


下 面 这 些 特 点 : 


O ”通过 搜索 和 发 现 机 制 (使 用 注册 服务 ) ， 提 供 找 到 基于 地 理 空间 ( geospatial-based ) 的 服 


D000 


提供 到 影像 和 其 他 基于 地 理 空间 的 应 用 服务 和 数据 服务 的 访问 ; 
与 Web/ 门 户 平台 的 整合 ; 

以 图 形 、 图 像 或 文字 形式 表现 地 理 空 间 信息 ; 

支持 通过 键盘 、 和 鼠标 或 其 他 人 机 界面 的 用 户 交 互 。 


应 用 服务 器 又 称 为 服务 器 端的 应 用 客户 (Server-side Application Clients) ， 它 们 在 网 络 的 服务 


器 上 而 不 是 在 用 户 的 桌 


应 用 程序 ， 如 图 像 处 理 。 


O ”由 调用 支撑 的 注册 、 处 理 、 描 绘 和 数据 服务 的 业务 逻辑 组 成 ; 
口 通过 Web/ 门 户 服务 器 ， 与 客户 端 应 用 程序 交互 。 


而 或 手持 设备 上 执行 ， 例 子 包括 计算 密集 (或 IO 密集 ) 的 基于 服务 器 的 


它们 的 特点 是 : 


从 逻辑 功能 上 ， 应 用 客户 基本 上 可 以 分 为 五 种 类 型 : 

CD 发 现 客户 (Discovery Client? 

收集 并 提交 用 户 输入 ,通过 注册 服务 查询 元 数据 ， 选 择 一 个 资源 (服务 或 数据 》 实例 ， 并 把 该 
资源 加 到 其 他 应 用 客户 层 里 。 查询 屏幕 可 以 包括 三 个 部 分 以 分 别 定义 文字 、 关键 字 和 地 理 上 的 搜索 


限制 。 
(2) 地 图 查看 客户 


(Map Viewer Client) 


表现 地 图 或 地 形 视图 , 如 在 地 图 背景 上 泻 染 和 显示 轨迹 和 动态 的 合 加 层 , 这 些 信息 可 以 来 自 不 
同 的 来 源 。 提 供 交 互 控制 能 力 ， 添 加 和 移 去 图 层 的 能 力 ， 创 建 、 选 择 和 显示 风格 的 能 力 。 
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(3) 增值 客户 (Value-Add Client) 

收集 并 提交 用 户 输入 , 用 用 户 自己 的 数据 增加 数据 生产 者 的 地 理 空间 信息 ， 创 建新 地 物 ， 更 新 
或 删除 已 有 地 物 。 类 似 地 图 查看 客户 ， 提 供 交互 控制 能 力 ， 添 加 与 移 去 图 层 的 能 力 ， 创 建 、 选 择 和 
显示 制图 风格 的 能 力 。 


(4) 影像 开发 客户 (Imagery Exploitation Client) 

提供 对 影像 的 访问 和 查看 并 开发 影像 的 工具 。 客 户 工具 的 例子 包括 平滑 连续 的 漫游 .镶嵌 显示 、 
图 像 内 烁 、 图 像 增强 、 测 量 、 分 类 和 注解 。 影 像 开发 客户 还 可 能 与 影像 一 起 查看 和 创建 矢量 特征 数 
据 ( 即 支持 增值 客户 的 能 力 〉。 


(5) 传感器 网 客户 (Sensor Web Client) 
提供 访问 、 管 理 和 开发 基于 网 络 的 传感器 资源 的 方法 。 


1.4.3 ”空间 信息 Web 服务 的 系统 框架 


在 空间 信息 Web 服务 中 ， 不 仅 要 能 存 取 内 容 ， 还 要 能 存 取 服 务 。 用 户 和 软件 代理 可 以 发 现 、 
调用 、 组 合 和 监控 提供 内 容 和 服务 的 资源 。 不 仅 能 提供 静态 的 内 容 ， 而 且 动态 控制 数据 、 地 图 的 产 
生 以 至 相关 的 物理 设备 。 

在 空间 信息 Web 服务 中 ， 重 要 的 是 建立 一 个 资源 描述 可 共享 的 框架 ， 它 能 够 发 布 、 发 现 、 建 
立 及 协调 Web 服务 。 一 个 空间 信息 Web 服务 的 实现 系统 应 具有 以 下 功能 : 


O ”每 个 服务 类 型 可 以 有 多 个 相互 独立 开发 的 实例 ; 

O ”不 同 种 类 的 服务 可 以 有 相互 独立 的 提供 者 ; 

O ”在 运行 时 能 够 根据 服务 类 型 、 可 存 取 的 内 容 、 服 务 的 特点 或 服务 质量 来 查找 相应 的 服务 
实例 ; 

可 以 存 取 时 空 数据 所 引用 的 元 数据 ; 

存 取 描述 服务 的 元 数据 ; 

根据 发 现 的 元 数据 来 调用 相应 的 服务 ; 

能 够 允许 组 织 、 协 调 及 序列 化 相关 的 服务 。 


根据 这 些 要求 ， 可 以 将 空间 信息 Web 服务 应 用 体系 分 成 以 下 几 个 层次 : 


(1) 空间 数据 库 层 ; 

(2) 基础 空间 数据 及 空间 操作 服务 层 ; 
(3) 元 数据 及 目录 服务 层 ; 

(4) 服务 管理 、 事 务 、 安 全 控制 ; 
(5) 服务 链 、 工 作 流 支持 层 ; 

(6) 应 用 集成 层 ; 

(7) 具体 的 应 用 层 。 


各 个 层次 的 主要 协议 如 图 1.7 所 示 。 
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服务 集成 及 
工作 流 


一 UDDLOGC-Catalog Registry 
一 wspr 


—OGC WFS, Coverage, Coordiate 
Transform, WMS 


—HTTP. SOAP, COM, CORBA, SQL, J2EE 


—WFSL.XLANGISO-19119 


HTML, XML/S, RDF, XML 


—TCP/IP.HTTPSSL.SMPT.FTP 
图 1.7 各 个 层次 的 主要 协议 


1.7 所 示 , 为 了 便于 实现 各 个 Web 服务 的 发 布 、 查找、 绑 定 及 调用 , 在 可 互 操作 的 GIS 中 
些 已 有 的 协议 。 


最 底层 是 通信 协议 ， 如 TCP/IP, HITP, SMTP, IOP, FIP 等 ; 在 数据 表示 及 编码 层 ， 使 用 
XML; 在 数据 格式 及 数据 Schema 层 , 使 用 HIML AA OGC 提出 的 表示 地 理 要 素 的 GML 等 。 
绑 定 层 主要 使 分 布 服务 成 为 可 能 ， 绑 定 是 在 网 络 上 连 到 服务 端点 的 机 制 ， 为 了 使 用 传统 
的 组 件 ， 在 该 层 可 以 使 用 COM，CORBA，J2EE 及 SQL 标准 , 而 HTTP 及 SOAP 是 绑 定 
到 Web Services 的 基本 协议 。 

在 服务 层 ， 可 以 建立 在 OGC 已 定义 了 的 简单 要 素 的 COM, CORBA 及 SQL 规范 的 基础 
上 ， 另外 一 些 规范 包括 栅 格 Coverage 规范 ， 坐 标 转换 ，Portrayal，Gazetteer，Geocoder， 
Geoparser 等 服务 规范 。 

服务 描述 层 用 来 产生 用 于 发 现 服务 的 基本 信息 ， 包 括 : 服务 类 型 信息 、 操 作 、 绑 定 规则 、 
服务 提供 者 的 网 络 地址 。 其 中 WSDL 是 现 阶段 的 标准 协议 。 

服务 的 发 现 层 是 发 布 和 查找 服务 。 服 务 的 发 现 层 使 用 服务 描述 层 的 信息 。UDDI 是 现在 
Web 服务 注册 和 发 现 的 标准 方式 ; OGC 制定 的 Catalog Service 规范 是 关于 空间 信息 内 容 
和 服务 的 发 现 服务 的 。 

最 顶层 是 服务 集成 层 ， 它 用 于 支持 决策 分 析 、 模 型 化 、 工 作 流 、 流 程 处 理 集成 等 。 已 有 
一 些 协议 如 WSFL，XLANG 等 ， 可 以 用 来 表示 工作 流 及 Web 服务 的 交互 与 集成 。 


空间 信息 Web 服务 中 的 基础 服务 
构建 基于 Web 服务 的 GIS， 需 要 定义 一 套 基本 的 地 理 信息 服务 ， 这 些 基本 服务 实现 地 理 


的 核心 功能 。OGC 制定 了 不 少 的 地 理 服 务 的 标准 ， 较 早 的 标准 主要 是 基于 HITP 对 服务 
现在 大 部 分 的 实现 标准 都 在 向 Web 服务 (基于 XML) 的 方向 转化 或 过 渡 。 


1. OWS 中 制定 的 信息 服务 接口 


同 其 


他 的 Web 服务 一 样 ， 核 心 的 地 理 信息 服务 也 用 接口 (Interface) 来 进行 表达 ， 相 同 的 服务 
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都 要 实现 相同 的 接口 ， 接 口 之 间 还 可 以 有 继承 关系 ， 如 图 1.8 与 表 1-1 所 示 。 
表 1-1 核心 的 地 理 信息 服务 的 接口 


服务 种 类 接口 继承 主要 接口 说 明 

WS (Web Service) GetCapabilities 服务 能 力 的 查询 

Web Registry Service ws RegisterService 注册 服务 信息 描述 
GetDescriptor 

WMS (Web Map Service) ws GetMap 获取 地 图 
GetFeatureInfo Feature 信息 

WFS (Web Feature Service) ws GetFeature 获取 Feature 
DescribeFeatureType Feature 类 型 描述 

WCS (Web Coverage Service) WS GetCoverage 获取 Coverage 

SLD (Styled Layer Description) WMS DescribeLayer 图 层 样式 

TWFS (Transaction WFS) WFS Transaction 事务 服务 
LockFeature Feature 加 锁 

GeoCoder WFS GeocodeFeature 地 理 编码 


Symbols 
m — 个 
ti 
| senice pem Generalization 


GetCapabilities i 


[l 
Web 
Feature Web Coverage 
Service Service 
| GetDescriptor ap Ó GetFeature — GetCoverage 
RegisterService GetFeatureInfo DecribeFeatureType 
Styled Layer ' 
Descriptor Transaction 
WFS 
Ó 
DescribeLayer 
LockFeature 
Transaction GeocodeFeature 


图 1.8 核心 的 地 理 信息 服务 接口 
x 1-1 列 出 了 不 同 种 类 的 服务 ， 分 别 介绍 如 下 : 
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口 WMS( Web Map Service ) 是 地 图 服务 , 它 将 有 相同 的 空间 参照 系 的 各 个 图 层 ( 包括 Feature 

图 层 及 Coverage 图 层 ) 组 合 在 一 起 。WMS 的 主要 接口 是 GetMap， 通 过 给 定 空间 坐标 及 

边界 范围 ， 可 以 得 到 相应 的 地 图 ， 图 形 的 格式 可 以 有 PNG, GIF, JPEG, TIFF 等 。 

O SLD (Styled Layer Descriptor) 是 WMS 中 的 一 种 重要 方式 ，SLD 是 将 图 层 中 的 各 个 要 素 

用 Style 进行 处 理 , 即 用 几何 对 象 或 图 标 来 表示 图 层 中 的 各 个 对 象 , 并 用 XML 进行 描述 。 

基于 SLD 的 WMS 的 服务 结果 ， 通 常 是 SVG、CGM、 了 PS 等 矢量 图 形 格式 。 

O WFS (Web Feature Service) 提供 对 地 理 Feature ( 要素 ) 的 存 取 。Feature 的 结果 通常 用 

基于 XML 的 GML ( Geographic Markup Language ) 进行 表达 ; 而 客户 在 向 服务 方 提出 的 

查询 请 求 可 以 用 基于 XML 的 Filter Encoding Specification( 过 滤 条 件 编码 语言 ) 进 行 表达 。 

口 WRS ( Web Registry Service) 为 Web 注册 服务 ， 是 对 元 数据 及 服务 进行 的 注册 服务 。 其 
中 ， 注 册 库 中 的 信息 可 以 包括 : 地 理 要 素 字典 、 服 务 注 册 库 、 数 据 模式 注册 库 、 传 感 器 
注册 。 

O Geocoder 服务 是 地 理 编码 服务 ， 是 按 地 名 或 其 他 属性 查询 到 相应 的 地 理 对 象 的 服务 ， 它 

可 以 提供 任何 地 理 对 象 相对 应 的 网 络 资源 的 地 址 。 


2. 常用 的 服务 及 规范 
常用 的 服务 包括 注册 服务 、 处 理 服 务 、 描 绘 服务 以 及 数据 服务 等 。 


(1) 注册 服务 (Registry Services) 

注册 服务 提供 了 一 个 分 类 、 注 册 、 描 述 、 搜 索 、 维 护 和 访问 Web 资源 信息 的 公共 机 制 。 注 册 
中 心 有 不 同 的 角色 ， 例 如 数据 类 型 目录 (地理 特征 、 履 盖 、 传 感 器 、 符 号 等 的 类 型 ) 、 在 线 数据 实 
例 目录 (数据 集 、 数 据 仓库 、 符 号 库 等 )、 服 务 类 型 目录 (Web Feature Server. Web Coverage Server. 
Web Map Server 等 ) 、 在 线 服 务实 例 目录 。 


(2) 处 理 服务 (Processing Services) 

处 理 服务 提供 对 地 理 空间 数据 进行 操作 的 服务 和 增值 服务 。 给 定 一 个 或 多 个 输入 , 处 理 服 务 在 
这 些 数据 上 执行 增值 处 理 并 产生 输出 。 处 理 服务 可 以 被 串联 起 来 以 完成 信息 生产 的 工作 流 和 决策 支 
持 。 这 种 服务 序列 叫做 服务 链 (Service Chain) ， 对 每 一 对 相 邻 服务 来 说 ， 后 面 服务 的 执行 依赖 于 
前 面 服务 的 输出 。 加 入 到 服务 链 后 ， 多 个 服务 就 组 合成 一 个 互相 依赖 的 序列 以 完成 更 大 的 任务 。 服 
务 链 要 求 在 链 内 所 有 服务 之 间 维 持 接口 的 一 致 性 , 这 说 明 相对 于 独立 的 服务 之 间 , 服务 链 内 各 服务 
之 间 的 耦合 性 要 紧密 的 多 。 

典型 的 处 理 服务 的 例子 包括 : 坐标 转换 服务 (Coordinate Transformation Service) 、 地 理 编码 
服务 (Geocoder Service) 、 地 名 词典 服务 (Gazetteer Service) 。 


(3) 描绘 服务 (Portrayal Services) 

描绘 服务 提供 对 地 理 空间 信息 进行 可 视 化 的 能 力 。 给 定 一 个 或 多 个 输入 , 描绘 服务 会 产生 泻 染 
后 的 输出 , 例如 地 图 的 制图 描绘 、 地 形 的 透视 图 、 影 像 的 注解 图 、 特 征地 物 在 时 间 和 空间 上 的 动态 
改变 等 。OGC 的 规范 里 定义 了 两 种 类 型 的 描绘 服务 : 


口 Web Map Service (WMS) 一 一 传递 以 图 形 方式 表示 的 地 图 作为 对 客户 查询 的 响应 。 地 图 
是 地 理 数 据 的 可 视 化 表现 ， 而 不 是 数据 本 身 。 通 常 泻 染 的 图 片 格式 有 PNG, GIF, JPEG, 
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基于 矢量 的 SVG 和 Web CGM 等 . 客户 在 从 WMS 请 求 地 图 时 需 指 定 图 层 名 称 和 图 形 大 
小 及 使 用 的 空间 参考 系 等 参数 。 客 户 还 可 以 向 不 同 的 WMS 实例 发 出 请 求 ， 将 结果 王 加 
以 形成 更 丰富 的 地 图 层 登 。 

Coverage Portrayal Service ( CPS) 一 一 定义 了 对 履 盖 数据 产生 可 视 化 图 片 的 标准 接口 。 履 
盖 数 据 (coverage data ) 是 指 网 格 化 的 地 理 空间 数据 ， 如 高 程 数 据 或 逐 感 影像 。CPS 通过 
在 瘦 客 户 ( 如 浏览 器 ) 上 显示 履 盖 的 视图 而 拓宽 了 履 盖 数据 的 应 用 。CPS 是 WMS 的 特 
例 ， 请 求 者 需要 指定 附加 的 对 履 盖 数据 特有 的 参数 。 有 时 ，CPS 还 需要 请 求 者 指定 目标 
WCS ( Web Coverage Service， 即 实际 提供 履 盖 数据 的 服务 ) 。 


(4) 数据 服务 (Data Services) 

数据 服务 提供 对 数据 库 和 数据 仓库 内 数据 集合 的 访问 。 数 据 服务 访问 的 资源 通常 通过 一 个 名 
称 如 标识 符 或 地 址 等 被 引用 , 给 定 一 个 名 称 ， 然 后 数据 服务 找到 这 个 资源 。 数 据 服 务 通常 维护 索引 
来 加 快 通过 名 称 或 其 他 属性 查找 数据 项 的 过 程 。OpenGIS 框架 定义 了 公共 的 编码 和 接口 ， 使 多 个 
分 布 式 数据 服务 的 内 容 以 一 致 的 方式 “暴露 ”给 框架 的 其 他 部 分 。OGC 的 规范 定义 或 计划 定义 的 
数据 服务 如 下 : 


口 


口 


口 
口 


Web Feature Service( WFS ) 一 一 提供 GML 表示 的 简单 地 理 空间 特征 数据 , 支持 INSERT、 
UPDATE、DELETE、QUERY 和 DISCOVERY 等 操作 ; 

Web Coverage Service (WCS) 一 一 提供 对 履 盖 数据 的 访问 ， 数 据 以 原始 值 而 非 泻 染 后 的 
图 片 传递 给 客户 ， 支 持 图 像 、 多 光谱 影像 、 高 程 数据 和 其 他 科学 数据 ; 

Sensor Collection Service ( SCS ) 提供 一 个 收集 和 访问 传感器 观察 数据 的 标准 接口 ; 
Image Archive Service (IAS) 一 一 该 服务 提供 对 大 数据 量 的 图 像 和 相关 元 数据 的 存储 和 访 
问 ， 支 持 新 图 像 的 添加 和 旧 图 像 的 删除 ， 本 身 可 能 不 支持 客户 端 定义 搜索 标准 的 查询 。 


(50 编码 

所 有 OpenGIS 框架 的 编码 规范 都 采用 XML Schema 来 定义 。 这 些 编码 描述 了 特定 的 词汇 表 ， 
用 于 在 应 用 客户 和 服务 之 间 、 服 务 与 服务 之 间 封 装 成 消息 的 数据 传输 。OGC 的 规范 定义 或 计划 定 
义 的 编码 如 下 : 


口 Geography Markup Language (GML) 一 一 地 理 置 标 语言 (GML ) 是 一 种 用 于 地 理 信息 


(包括 地 理 特征 的 几何 和 属性 ) 传 输 和 存储 的 XML 编码 . 如 同 《OpenGIS 简单 特征 规范 》 
( OpenGIS Simple Feature Specification ), GML 也 采用 了 《OpenGIS 抽象 规范 》( OpenGIS 
Abstract Specification ) 的 几何 模型 。 与 《简单 特征 规范 》 不 同 的 是 ，GML 规范 包含 处 理 
复杂 类 型 属性 的 能 力 。 
XML for Image and Map Annotation ( XIMA) 一 一 XIMA 定义 了 一 个 XML 词汇 表 来 对 影 
像 、 地 图 和 其 他 地 理 空间 数据 上 的 注 记 进行 编码 。XIMA 利用 GML 来 表达 这 些 注 记 的 
位 置 ， 并 把 每 个 注 记 和 其 描述 的 地 理 空间 资源 关联 起 来 。 
Styled Layer Descriptor ( SLD) 一 一 风格 化 图 层 描 述 符 指定 了 一 种 地 图 风格 语言 的 格式 ， 
以 产生 具有 用 户 定 义 风格 的 地 图 。 它 满足 了 人 或 机 器 对 地 理 空间 数据 的 可 视 表现 进行 控 
制 的 需要 。 一 个 风格 化 的 图 层 代 表 图 层 和 风格 的 特别 组 合 ， 图 层 定义 了 特征 流 ， 风 格 定 
义 了 这 些 特征 被 符号 化 后 的 风格 。 一 个 图 层 可 被 符号 化 成 多 种 风格 ， 这 种 关系 类 似 于 
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XML 可 被 表现 成 HIML、WML、PDF、RTF 等 多 种 形式 。 

D Location Organizer Folder (LOF) 一 一 LOF 是 一 个 GML 应 用 程序 模式 ， 提 供 了 一 个 结构 来 
组 织 特定 区 域 或 感 兴趣 区 的 相关 信息 。 它 可 以 被 用 于 各 种 分 析 应 用 里 ， 如 灾害 分 析 、 情 报 分 
MF. LOF 是 一 个 信息 容器 ,包含 在 空间 上 组 织 的 属于 某 个 地 理 区 域 的 信息 资源 ( 空间 的 和 
非 空间 的 ) 集合 。 许 多 其 他 的 服务 可 以 通过 添加 、 修 改 或 引用 里 面 的 资源 来 操作 LOF. 

m Service Metadata 一 一 服务 元 数据 是 一 个 XML 词汇 表 ， 由 描述 一 个 服务 不 同方 面 的 几 个 
单元 组 成 。 第 一 单元 以 足够 的 细节 描述 服务 的 接口 ， 使 一 个 自动 化 的 进程 能 够 读 取 描述 
并 调用 该 服务 所 宣称 的 操作 。 第 二 单元 描述 了 服务 的 数据 内 容 (或 其 操作 的 数据 ) ， 使 
服务 请 求 者 能 够 动态 的 制作 请 求 。 这 个 部 分 是 可 选 的 ， 取 决 于 该 服务 是 否 包含 或 操作 数 
据 内 容 。 余 下 的 描述 单元 提供 对 特定 的 服务 类 型 或 服务 实例 专 有 的 信息 。 

O Image Metadata 一 图 像 元 数据 是 一 个 XML 编码 ， 预 期 会 改编 自 ISO/DIS 19115 元 数据 
国际 标准 草案 以 充分 描述 OGC 服务 模型 可 以 处 理 的 所 有 图 像 类 型 。 

O SensorML Sensor 一 一 置 标语 言 定义 了 一 个 XML Schema, 描述 传感器 类 型 和 实例 的 几何 、 
动态 和 观测 特性 。 

口 Observations and Measurements 一 一 观察 和 测量 定义 了 一 个 框架 和 XML 编码 ， 主 要 用 于 
传感器 网 的 环境 里 。 


1.5 GIS 的 Web 服务 实现 方式 


在 了 解 GIS 的 一 些 基本 概念 后 , 我 们 来 看 看 基于 Web Service 的 GIS 系统 是 如 何 实现 对 服务 的 
请 求 与 响应 的 。 在 此 之 前 ， 先 来 了 解 一 下 版 本 号 。 


1.5.4 版 本 与 流通 


版 本 号 为 三 段 数字 表示 ， 现 在 WFS 的 最 新 版 本 是 1.1.0， 旧 版 本 有 0.9.1、1.0.0; WMS 的 版 本 
有 : 1.0、1.1、1.1.1、1.3.0。 支 持 WFS1.0、WMS1.1.1， 其 返回 的 GML 版 本 是 2.1.2。 

版 本 号 必须 出 现在 两 个 地 方 , 一 是 客户 端 请 求 参数 中 、 二 是 服务 器 GetCapabilities 操作 返回 的 
Capabilities XML 文档 中 。 

需要 注意 的 是 ， 客 户 端 请求 的 版 本 号 应 该 与 服务 器 支持 的 版 本 号 匹配 ， 否 则 按 最 近 匹 配 原则 : 


(1) 如 果 客户 端 请 求 的 版 本 号 高 于 服务 器 支持 的 ， 服 务 器 按 其 支持 的 最 高 的 版 本 号 执行 ， 相 
反 ， 则 按 最 低 版 本 号 执行 。 

C2 如 果 服 务 器 响应 的 版 本 号 高 于 客户 端 支持 的 , 客户 端 会 重新 发 送 一 个 较 低 版 本 号 的 请 求 ， 
相反 ， 发 送 一 个 较 高 的 版 本 。 图 1.9 是 以 WFS 为 例 的 版 本 匹配 示意 图 。 
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二 


图 1.9 版 本 匹配 示意 图 


1.5.2 ”请 求 规则 


请 求 方式 有 两 种 ， 分 别 是 Get 与 Post。 我 们 下 面 以 访问 “测绘 科学 数据 共享 服务 网 ” 
(http://sms.webmap.cn/default.asp》 为 例 来 介绍 WMS 或 WFS 服务 对 数据 进行 互 操作 的 方法 。 
首先 需要 调用 GetCapabilities 接口 来 获得 服务 的 描述 。 在 浏览 器 的 地 址 栏 中 输入 如 下 地 址 : 


http://sms.webmap.cn/scripts/openserv.exe?map-/sms ogc/sms500.map&version-1.1.1 &service-WMS &reque 
st-GetCapabilities 


上 面 是 一 个 Get 请 求 。 其 中 http://sms.webmap.cn/scripts/openserv.exe 是 响应 请 求 的 路 径 ， 后 面 
是 参数 。 其 中 request=GetCapabilities 表示 请 求 的 是 GetCapabilities 操作 ，service=WMS 表示 服务 是 
WMS ，version=1.1.1 表示 使 用 1.1.1 的 版 本 ,这 些 都 是 OGC 规范 中 明确 要 求 的 。 而 
map-/sms ogc/sms500.map 表示 的 是 查询 的 是 “1:500 万 数字 地 理 底 图 ”， 这 是 测绘 科学 数据 共享 
服务 网 自己 定义 的 。 

上 面 的 地 址 返回 或 打开 一 个 XML 格式 的 文件 , 内 容 如 下 (为 了 节省 篇 幅 , 删 简 了 一 些 重复 内 容 ) : 


<WMT MS Capabilities version="1.1.1"> 


SIS gam 


«Service» 
«Name»0GC : WMS« /Name» 
<Title> 测 绘 科学 数据 共享 服务 系统 </Title> 
<Abstract> 基 于 地 理 信 息 互 操 作 规范 提供 测绘 科学 数据 的 在 线 服务 </Abstract> 
<KeywordList> 
<Keyword> 测 绘 </Keyword> 
<Keyword> 互 操作 </Keyword> 
</KeywordList> 
«ContactInformation» 
«ContactElectronicMailAddress»apsdinodeensdi.gov.cn 
«/ContactElectronicMailAddress» 
«/ContactInformation» 
«/Service» 


«Capability» 
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<Request> 

<GetCapabilities> 
<Format>application/vnd.ogc.wms xml</Format> 

</GetCapabilities> 

<GetMap> 
<Format>image/png</Format> 
<Format>image/tiff</Format> 
<Format>image/gif</Format> 
<Format>image/png; mode=24bit</Format> 
<Format>image/jpeg</Format> 
<Format>image/wbmp</Format> 
<DCPType> 

<HTTP> 

<Get><OnlineResource 
xmlns:xlink-"http://www.w3.0rg/1999/xlink" 
xlink:href-"http://sms.webmap.cn/scripts/mapserv.exe?map-/sms ogc/sms500.m 

ap&"/»«/Get» 

«Post»«OnlineResource 
xmlns:xlink-"http://www.w3.0rg/1999/xlink" 
xlink:href-"http://sms.webmap.cn/scripts/mapserv.exe?map-/sms ogc/sms500.m 

ap&"/»«/Post» 
«/HTTP» 
«/DCPType» 

«/GetMap» 

«GetFeatureInfo» 
«Format^text/plain«/Format» 
«Format»text/html«/Format» 
«Format»application/vnd.ogc.gml«/Format» 

«/GetFeatureInfo» 

«DescribeLayer» 
X«Format»text/xml«/Format» 

«/DescribeLayer» 

«GetLegendGraphic^ 
«Format»image/pngc/Format^» 
«Format»image/gif«/Format» 

«/GetLegendGraphic» 

«/Request» 
«Layer» 

XName»sms ogcservice«/Name» 

<Title> 测 绘 科学 数据 共享 服务 系统 </Title> 

<SRS>EPSG:4326</SRS> 

<LatLonBoundingBox minx-"106.001" 

miny-"2.29468e-005" 
maxx-"106.001" maxy-"0.000420795" /» 

XLayer» 

<Name>BOUNT</Name> 
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<Title> 境 界 </Title> 
<Abstract> 境 界 </Abstract> 
XLayer queryable-"0" opaque-"1" cascaded="0"> 
«Name»BOUNT500point«/Name» 
«Title»1:500 万 数字 地 理 底 图 境界 要 素数 据 集 点 状 要 素 层 </Title> 
<KeywordList> 
<Keyword> 境 界 </Keyword> 
</KeywordList> 
<SRS>EPSG:4326</SRS> 
XLatLonBoundingBox minx-"69.5965" 
miny-"1.8943" 
maxx-"135.524" maxy-"53.873" /» 
XDataURL» 
XFormat»text/txt«/Format» 
«OnlineResource 
xmlns:xlink-http://www.w3.0rg/1999/xlink 
xlink:type-"simple" 
xlink:href-"http://sms.webmap.cn/dldata/BOUNT600.e00"/» 
«/DataURL» 
«Style» 
«Name»default«/Name» 
«Title»default«/Title» 
XLegendURL width-"20" height-"10"» 

«Format»image/png«/Format» 

«OnlineResource 
xmlns:xlink-"http://www.w3.0rg/1999/xlink" 
xlink:type-"simple" 
xlink:href - "http://sms.webmap.cn/scripts/mapserv.exe? 

map-/sms ogc/sms500.map & version-1.1.1&service-WMS &request-GetLegendGraphic & 
layer-BOUNT500point & format-image/png"/» 
</LegendURL> 
«/Style» 
X/Layer» 
</Layer> 
</Capability> 


</WMT MS Capabilities» 


其 中 ，<Service> 与 </Service> 之 间 一 段 的 内 容 描述 的 是 该 服务 的 名 称 、 关 键 词 以 及 联系 信息 等 。 
<Capability> 与 </Capability> 之 间 描 述 了 该 服务 支持 的 操作 以 及 包含 的 图 层 。 其 中 <Request> 与 
</Request> 之 间 描 述 的 是 该 服务 支持 的 操作 , 从 上 述 响 应 可 看 出 该 服务 支持 GetCapabilities、GetMap 
(得 到 地 图 ) GetFeatureInfo (得 到 地 物 属性 ) ~ DescribeLayer (描述 图 层 ) 与 GetLegendGraphic 
(得 到 图 例 ) 操作 。<Layer> 与 </Layer> 之 间 罗 列 了 该 服务 所 包含 的 所 有 图 层 数据 。 
在 <GetMap> 与 </GetMap> 中 的 Format 列 出 了 GetMap 请求 所 支持 的 返回 图 片 的 格式 ,包括 png、 
tiff, gif, jpeg, wbmp 等 格式 ，DCPType 中 规定 了 请 求 的 方式 ， 上 面 的 例子 表示 支持 HTTP 的 Get 
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与 Post 两 种 方式 。 从 该 响应 我 们 可 构造 GetMap 请 求 获取 某 图 层 或 某 些 图 层 指定 范围 的 地 图 。 
1.5.3 ”响应 举例 
在 浏览 器 的 地 址 栏 中 输入 如 下 请 求 ， 将 得 到 如 图 1.10 所 示 的 一 张 图 片 。 
http://sms.webmap.cn/scripts/openserv.exe?map=/sms_ogc/sms500.map&&version=1.1.1 &service= 


WMsS&request-GetMap&srs-EPSG:4326&bbox-67,3,137,55&format-image/png&layers-ROALN500a 
rc&transparent-true 


图 1.10 ”使 用 GetMap 得 到 我 国 1:500 万 数字 地 理 底 图 公路 数据 地 图 


Jh, request-GetMap 表示 执行 GetMap 操作 ，service=WMS 表示 使 用 WMS 服务 ，srs=EPSG:4326 表 
示 使 用 坐标 参考 系统 为 EPSG:4326，bbox=67,3,137,55 表示 地 图 范围 (这 里 以 经 纬度 表示 )， 
layers=ROALN500arc 表示 请 求 图 层 为 ROALN500arc, format=image/png 表示 返回 的 地 图 图 片 格式 为 
png, transparent-true 表示 透明 显示 。 由 于 没有 style 参数 ， 表 示 使 用 默认 样式 绘制 图 层 。 

我 们 再 以 TerraService.net 为 例 来 说 明 。TerraService 是 在 TerraServer Database 基础 上 发 展 起 来 
的 Web 服务 。 该 数据 库 含 有 United States Geological Survey (USGS) 的 15TB 的 航空 数据 及 1.5TB 
的 地 形 数据 ，TerraService 在 该 数据 库 基 础 上 建立 了 一 套 服 务 ， 使 用 的 平台 是 MicrosoftNET， 服 务 
的 主要 接口 是 GetMap， 另 外 它 提供 了 针对 给 定 范围 的 地 图 拼接 功能 。 

通过 如 下 地 址 可 得 到 GetCapabilities 的 XML 文档 : 


http//www.terraservice.net/ogccapabilities.ashx?version- 1.1.1 &request-getcapabilities&service-wms 
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ffs 
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该 文档 指明 GetMap 请 求 的 地 址 为 http://terraservice.net/ogcmap.ashx。 因 此 可 构造 如 下 类 似 的 
GetMap 请 求 来 得 到 相应 范围 的 航空 影像 : 


http://www.terraservice.net/ogcmap.ashx?version- 1.1.1 &request-GetMap&Layers-UrbanArea&St 
yles-&SRS-EPSG:26910&BBOX-547200,4180400,553600,.4184400&width-800&height-500& format 
—jmage/jpeg&Exceptions-se xml 


该 请 求 版 本 为 1.1.1， 执 行 GetMap 操作 ， 请 求 图 层 为 UrbanArea， 使 用 默认 样式 绘制 图 层 ， 坐 
标 参 考 系 统 使 用 EPSG:26910， 地 图 范围 为 547200.4180400,553600.4184400， 返 回 的 图 片 宽 为 800 
像素 ， 高 为 500 像素 ， 格 式 为 jpeg。 该 请 求 的 返回 结果 如 图 1.11 所 示 。 


, 
py (cp YE 二 
] 二 


È 


eiaa vk 


1.11 通过 GetMap 操作 得 到 指定 范围 的 航空 影像 


再 例如 ， 通 过 如 下 请 求 ， 可 得 到 如 图 1.12 所 示 的 地 形 图 : 


http://www.terraservice.net/ogcmap.ashx?version- 1.1. 1 &request-GetMap&Layers- DRG&Styles- 
&SRS-EPSG:26910&BBOX-524800,4166400,576000,4198400&width-800&height-500& format-ima 
ge/jpeg&Exceptions-se xml 
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图 1.12 通过 GetMap 操作 得 到 指定 范围 的 数字 栅 格 地 形 图 


ArcGIS Server 是 一 个 基于 Web 的 企业 级 GIS 解决 方案 ， 它 从 ArcGIS 9.0 版 本 开始 加 入 
ESRI 产品 家 族 .ArcGIS Server 为 创建 和 管理 基于 服务 器 的 GIS 应 用 提供 了 一 个 高 效 的 框架 平 
人 台 。 它 充分 利用 了 ArcGIS 的 核心 组 件 库 ArcObjects (简称 AO) ， 并 且 基 于 工业 标准 提供 
Web GIS 服务 。ArcGIS Server 将 两 项 功能 强大 的 技术 一 一 GIS 和 网 络 技术 结合 在 一 起 ，GIS 
擅长 与 空间 相关 的 分 析 和 处 理 ， 网 络 技术 则 提供 全 球 互 联 ， 促 进 信息 共享 。 这 两 项 技术 协同 
IF, AREY. 

在 本 章 的 内 容 中 你 将 了 解 : 


2.1 ArcGIS Server 9.2 主要 功能 

22 ArcGIS Server. 的 产品 级 别 分 类 
23 ArcGIS Server 9.2 系统 组 成 部 分 
24 ArcGIS Server 包含 的 主要 技术 
2.5 ArcGIS Server 9.2 安装 


第 2 章 ArcGIS Server 9.2 简介 与 安装 4 


与 过 去 的 Web GIS 产品 相 比 ，ArcGIS Server 不 仅 具 备 发 布地 图 服务 的 功能 ， 而 且 还 能 提供 灵 
活 的 编辑 和 强大 的 分 析 能 力 , 这 对 于 Web GIS 发 展 可 以 说 是 具备 里 程 碑 意义 的 。 由 于 ArcGIS Server 
基于 强大 的 核心 组 件 库 ArcObjects 搭建 ， 并 且 以 主流 的 网 络 技术 作为 其 通信 手段 ， 所 以 它 具 有 许 
多 优势 和 特点 ， 例 如 : 


(1) 集中 式 管 理 带 来 成 本 的 降低 。 无 论 是 从 数据 的 维护 和 管理 上 还 是 从 系统 升级 上 来 说 ， 都 
只 需要 在 服务 器 端 进行 集中 的 处 理 , 而 无 需 在 每 一 个 终端 用 户 上 做 大 量 的 维护 工作 , 这 不 但 极 大 地 
节约 投入 的 时 间 成 本 和 人 力 资源 ， 而 且 有 利于 提高 数据 的 一 致 性 。 

(2) 瘦 客 户 端 也 可 以 享受 到 高 级 的 GIS 服务 。 过 去 只 能 在 庞大 的 桌面 软件 上 才能 实现 的 高 
GIS 功能 的 时 代 终 止 于 ArcGIS Server。 通 过 ArcGIS Server 搭建 的 企业 GIS 服务 使 得 客户 端 通过 网 
页 浏览 器 即 可 实现 高 级 的 GIS 功能 。 

(3) fii Web GIS 具备 了 灵活 的 数据 编辑 和 高 级 的 GIS 分 析 能 力 。 用 户 在 野外 作业 时 可 以 通过 移 
动 设备 直接 对 服务 器 端的 数据 库 进行 维护 和 更 新 ， 大 大 减少 了 回 到 室内 后 的 重复 工作 量 ， 为 时 外 调 绘 
和 勘察 提供 了 极 大 的 便利 。 另 外 ，ArcGIS Server 可 以 实现 网 络 分 析 和 3D 分 析 等 高 级 的 空间 分 析 功能 。 

(4) 支持 大 量 的 并 发 访问 ， 具 有 负载 均衡 能 力 。ArcGIS Server 采用 分 布 式 组 件 技术 ， 可 以 将 
大 量 的 并 发 访问 均衡 地 分 配 到 多 个 服务 器 上 ， 可 以 大 幅度 降低 响应 时 间 ， 提 高 并 发 访问 量 。 

(5) 可 以 根据 工业 标准 很 好 的 与 其 他 的 企业 系统 整合 ， 进 行 协同 工作 ， 为 企业 经 营 管理 提供 
支持 。 例 如 : GIS 和 客户 关系 管理 系统 (CRM) 整合 ， 发 挥 GIS 的 独特 优势 ， 使 得 企业 可 以 打破 
地 域 的 限制 ， 更 好 的 进行 客户 资源 的 开发 ， 提 供 客户 满意 的 产品 和 服务 。 

(6) ArcGIS Server 的 出 现 使 得 我 们 可 以 利用 主流 的 网 络 技术 〈 例 如 .Net 和 Java). 来 定制 适合 
自身 需要 的 网 络 GIS 解决 方案 ， 具 有 更 大 的 可 伸缩 性 来 满足 多 样 化 的 企业 需求 。 


2.1 ArcGIS Server 9.2 主要 功能 


ArcGIS Server 是 功能 强大 的 基于 服务 器 的 GIS 产品 ， 用 于 构建 集中 管理 的 、 支 持 多 用 户 的 、 
有 具备 高 级 GIS 功能 的 企业 级 GIS 应 用 与 服务 ， 如 空间 数据 管理 、 二 维 三 维 地 图 可 视 化 、 数 据 编辑 、 
空间 分 析 等 即 拿 即 用 的 应 用 和 类 型 丰富 的 服务 。ArcGIS Server 是 用 户 创建 工作 组 、 部 门 和 企业 级 
GIS 应 用 的 平台 ， 通 过 ArcGIS Server 创建 集中 管理 的 、 支 持 多 用 户 的 、 提 供 丰 富 GIS 功能 、 并 且 
满足 工业 标准 GIS 应 用 。ArcGIS Server 提供 广泛 的 基于 Web 的 GIS 服务 ， 以 支持 在 分 布 式 环境 下 
实现 地 理 数 据 管理 、 制 图 、 地 理 处 理 、 空 间 分 析 、 编 辑 和 其 他 的 GIS 功能 。 其 主要 功能 包括 : 


提供 通用 的 框架 在 企业 内 部 建立 和 分 发 GIS 应 用 ; 

提供 操作 简单 、 易 于 配置 的 Web 应 用 ; 

提供 广泛 的 基于 Web 的 空间 数据 获取 功能 ; 

提供 通用 的 GIS 数据 管理 框架 ; 

支持 在 线 的 空间 数据 编辑 和 专业 分 析 ; 

支持 二 维 三 维 地 图 可 视 化 ; 

除 标准 浏览 器 外 ， 还 支持 ArcGIS Desktop 和 ArcGIS Explorer 等 桌面 客户 端 ; 
可 以 集成 多 种 GIS 服务 ; 


DOOOOODO m 
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支持 标准 的 WMS, WFS; 

提供 配置 、 发 布 和 优化 GIS 服务 器 的 管理 工具 ; 

提供 NET 和 Java 软件 开发 工具 包 ; 

为 移动 客户 提供 应 用 开发 框架 (只 包含 的 NET 开 发 工具 包 中 ) 。 


实际 上 ，ArcGIS Server 功能 可 以 分 为 两 大 类 。 

一 类 是 它 本 身 就 是 一 个 完整 的 、 集 成 的 服务 器 端 地 理 信息 系统 , 提供 了 许多 即 拿 即 用 的 空间 数 
据 、 空 间 分 析 、 制 图 等 的 应 用 与 Web 服务 ， 这 些 服务 可 供 ESRI 产品 家 族 中 的 ArcGIS 桌面 应 用 
程序 (ArcMap、ArcCatalogue $) ArcGIS Explorer (免费 产品 ， 可 自由 下 载 ) 使 用 ， 也 可 供 支持 
相关 标准 协议 的 应 用 使 用 ， 还 可 供 嵌 入 到 自行 开发 的 应 用 系统 中 。 如 图 2.1 所 示 。 
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图 2.1 ArcGIS Server 9.2 功能 (服务 视图 ) 


另 一 类 是 对 再 次 开发 支持 的 功能 ， 即 AreGIS Server 为 NET 与 Java 分 别提 供 了 一 套 应 用 程序 
开发 框架 (Application Development Framework， 简 称 ADF) ， 如 图 2.2 所 示 。 应 用 程序 开发 框架 
可 以 帮助 用 户 创建 和 配置 .NET 或 者 Java 桌面 和 网 络 应 用 ， 它 们 在 GIS Server 中 运行 时 需要 调用 
ArcObjects。ADF 包含 一 个 软件 开发 工具 包 (SDK) ， 其 中 有 软件 对 象 、 网 络 控件 、 网 络 应 用 模板 、 
开发 者 帮助 、 和 源 代码 范例 。 还 包含 了 一 个 网 络 应 用 程序 运行 时 CWeb Application Run Time? ， 
这 样 无 需 在 自己 的 服务 器 上 安装 ArcObjects 就 可 以 配置 应 用 网 络 应 用 程序 。 

ArcGIS 


Mobile Business 
Applications 
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Software Development Kit (SDK) 


图 2.2 ArcGIS Server 9:2 功能 〈 应 用 程序 开发 框架 视图 ) 
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按 这 两 类 分 类 的 ArcGIS Server 功能 如 表 2-1 所 示 。 


表 2-1 ArcGIS Server 功能 


即 拿 即 用 的 ArcGIS Web 服务 ArcGIS Server 开发 支持 功能 
二 维 与 三 维 地 图 服务 基于 Ajax 的 Web 应 用 
地 理 编码 服务 可 以 使 用 Microsoft Windows 移动 开发 技术 的 开发 
移动 应 用 
用 于 工作 流 自动 化 和 分 析 的 空间 处 理 服 务 可 以 通过 ArcSDE 和 SQL API 操作 空间 数据 库 
空间 数据 管理 服务 通过 SOAP 定制 Web 服务 
支持 SOAP、OGC WMS 和 KML 与 面向 服务 的 体系 结构 (SOA) 集成 
从 图 2.2 可 以 看 出 ，ArcGIS Server 为 NET 与 Java 分 别提 供 Web 服务 与 开发 支持 ， 这 两 类 版 
本 的 功能 有 些 细微 的 差别 。 


(1) ArcGIS Server .NET 功能 
ArcGIS Server .NET 地 理 Web 服务 功能 包括 : 


DOOOOOODODD 


在 各 种 指定 的 比例 尺 下 ， 使 用 一 个 预 处 理 的 2D 地 图 高 速 缓冲 存储 器 来 更 快 显示 地 图 ; 
执行 空间 处 理 的 工具 和 模型 ; 

创建 和 发 布 ArcGIS Explorer 地 图 ; 

基于 空间 处 理 来 创建 和 发 布 ArcGIS Explorer 任务 ; 

执行 geodatabase 的 复制 ， 同 步 和 检 出 ; 

以 KML 形式 为 Google Earth 动态 的 提供 地 图 ; 

以 WMS 服务 形式 为 WMS 浏览 器 动态 的 提供 地 图 ; 

使 用 网 络 服务 发 布 器 发 布 标准 的 SOAP 网 络 服务 ; 

使 用 预先 构建 的 3DGlobe 数据 高 速 缓冲 存储 器 为 ArcGIS 桌面 客户 端 ( ArcGlobe, ArcGIS 
Explorer，ArcGlobe 控件 ，ArcReader ) 提供 3D Globe 数据 ， 从 而 获取 快速 的 3D 性 能 ; 
使 用 全 新 的 数据 互 操作 扩展 模块 来 通过 空间 处 理 执行 提取 ， 转 换 和 装载 (ETL) 服务 ; 
用 Maplex 对 所 需 的 动态 地 图 和 地 图 进行 标注 。 


ArcGIS Server NET 应 用 程序 的 构建 功能 包括 : 


口 
口 


DOLO 


增强 的 高 性 能 Web 地 图 浏览 器 工具 ， 包 括 无 缝 漫游、 动态 缩放 、 地 图 提示 、 键 盘 快捷 键 ; 
非 开发 人 员 通 过 构建 网 站 工具 可 以 快速 地 创建 Web 应 用 ; 

使 用 全 新 的 多 服务 构架 ， 在 一 个 网 络 应 用 程序 中 集成 多 种 GIS 服务 (如 ArcGIS Server. 
ArcIMS, WMS 5 ArcWeb 服务 等 ) ; 

£j Visual Studio 2005 无 颖 集成 ， 包 括 WEB 控件 和 应 用 模板 ， 用 于 构建 面向 GIS 任务 的 
Web 应 用 ; 

用 全 新 的 移动 ADF 开发 轻 量 级 的 ， 易 于 配置 的 应 用 程序 ， 供 桌面 和 移动 设备 使 用 ; 

使 用 Server 对 象 扩 展 来 客户 化 功能 ， 从 而 扩展 server 对 象 ; 

为 服务 器 应 用 程序 获取 故障 恢复 (failover) 和 轮转 调度 (round-robin) 支持 。 


S519 qam 


SIS gam 


30 j b Web GIS 开发 一 一 ArcGIS Server 与 .NET 


(2) ArcGIS Server Java 功能 
ArcGIS Server Java 地 理 Web 服务 功能 包括 : 


DoOOOOODO DO 


0000 


在 各 种 指定 的 比例 尺 下 ， 使 用 一 个 预 处 理 的 2D 地 图 高 速 缓冲 存储 器 来 更 快 显示 地 图 ; 
执行 空间 处 理 的 工具 和 模型 ; 

创建 和 发 布 ArcGIS Explorer 地 图 ; 

基于 空间 处 理 来 创建 和 发 布 ArcGIS Explorer 任务 ; 

执行 geodatabase 的 复制 ， 同 步 ， 还 有 检 出 ; 

以 KML 形式 为 Google Earth 动态 的 提供 地 图 ; 

以 WMS 服务 形式 为 WMS 浏览 器 动态 的 提供 地 图 ; 

使 用 预先 构建 的 3DGlobe 数据 高 速 缓 冲 存储 器 为 ArcGIS 桌面 客户 端 ( ArcGlobe, ArcGIS 
Explorer, ArcGlobe 控件 ，ArcReader ) 提供 3D Globe 数据 ， 从 而 获取 快速 的 3D 性 能 ; 
用 Maplex 对 所 需 的 动态 地 图 和 地 图 进行 标注 ; 

用 一 个 全 新 的 基于 网 络 的 Java 管理 工具 来 管理 你 的 服务 器 ; 

通过 标准 的 UNIX 认证 ( 必须 要 Windows 认证 ) 来 验证 用 户 ; 

使 用 全 新 的 数据 互 操作 扩展 模块 来 通过 空间 处 理 创建 ETL 服务 。 


ArcGIS Server Java 应 用 程序 的 构建 功能 包括 : 


增强 的 高 性 能 Web 地 图 浏览 器 工具 ， 包 括 无 缝 漫游、 动态 缩放 、 地 图 提示 、 键 盘 快 捷 键 ; 
非 开 发 人 员 通 过 构建 网 站 工具 可 以 快速 地 创建 web 应 用 ; 

使 用 全 新 的 多 服务 构架 ， 在 一 个 Web 应 用 程序 中 集成 多 种 GIS 服务 ( 如 ArcGIS Server. 
ArcIMS. WMS 与 ArcWeb 服务 等 ) ; 

与 Eclipse 和 Sun Creator 无 终 集 成， 包括 web 控件 和 应 用 模板 ， 用 于 构建 面向 GIS 任务 
的 web Jf; 

使 用 了 新 的 企业 级 ADF 中 包含 的 细 粒 的 空间 企业 级 JavaBeans， 用 于 开发 企业 级 Web 应 
用 程序 ; 

使 用 改良 的 Java API; 

为 服务 器 应 用 程序 获取 故障 移交 ( failover ) 和 轮转 调度 (round-robin) 支持 。 


2.2 ArcGIS Server 的 产品 级 别 分 类 


为 了 满足 工作 组 级 、 部 门 级 、 以 及 企业 级 的 需求 ，ArcGIS Server 依据 其 功能 和 服务 器 规模 差 
异 ， 提 供 了 一 个 可 伸缩 的 产品 线 。ArcGIS Server 从 服务 器 规模 上 分 为 工作 组 级 和 企业 级 两 个 级 别 ; 
又 从 功能 上 分 为 基础 版 、 标 准 版 与 高 级 版 三 个 级 别 的 版 本 。 因 此 ArcGIS Server 包括 了 6 个 不 同 级 
别 的 产品 。 
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22.1 按 功能 分 级 


从 功能 上 ArcGIS Server 分 为 基础 版 、 标 准 版 与 高 级 版 三 个 级 别 的 版 本 。 


Q ”基础 版 为 用 户 提供 用 于 空间 数据 管理 的 GIS 服务 器 . 它 主要 利用 ArcSDE 技术 来 组 织 和 

管理 地 理 数据 集 。 

D ”标准 版 为 用 户 提供 用 于 空间 数据 管理 和 可 视 化 (制图 ) 的 GIS 服务 器 。 它 的 功能 包括 二 
维 制图 、 三 维 渔 染 服 务 和 一 系列 相关 功能 ， 如 地 理 编 码 、 地 名 辞典 和 路 径 分 析 。 应 用 开 
发 人 员 可 以 通过 访问 组 件 (对 象 、Web 控件 和 服务 ) 来 构建 Java 和 .NET 框架 下 的 解决 
方案 。ArcGIS Server 标准 版 包含 所 有 基础 版 的 功能 。 

口 高 级 版 为 用 户 提 供用 于 空间 数据 管理 、 制 图 、3D 可 视 化 和 基于 浏览 器 的 编辑 、 地 理 处 理 、 

空间 分 析 、 建 模 等 功能 。 高 级 版 包含 所 有 基础 版 和 标准 版 的 功能 。 对 于 开发 人 员 而 言 ， 

高 级 版 含有 多 层 组 件 用 于 为 桌面 、 移 动 客户 端 、 智 能 客户 端 、 网 络 浏览 器 和 企业 模式 构 

建 和 部 署 Java 和 .NET 的 应 用 和 服务 。 


三 个 版 本 的 功能 比较 如 表 2-2 所 示 。 


表 2-2 ArcGIS Server 基础 版 、 标 准 版 与 高 级 版 功能 的 比较 


功能 基础 版 标准 版 高 级 版 
多 用 户 空 间 数 据 库 有 有 有 
基于 Web 的 复制 有 有 有 
Web 制图 无 有 有 
三 维 服务 无 有 有 
地 理 处 理 无 有 限 有 
HUB Web 的 编辑 无 无 有 
移动 应 用 无 无 有 


2.22 j&HUS 


ArcGIS Server TFH (Workgroup) 的 ArcGISServer 仅 能 运行 于 单 台 单 CPU socket. CZ 
或 双核 ) 的 机 器 上 ， 并 且 使 用 Microsoft SQL Server Express 数据 库 引 擎 支持 空间 数据 库 。 
ArcGISServer 企业 级 〈Enterprise) 的 ArcGISServer 可 以 运行 在 一 台 或 多 台 机 器 上 ， 并 且 每 台 
机 器 可 以 有 多 于 2 个 CPU socket。ArcGIS Server 企业 级 包 ArcSDE， 用 户 需要 自行 提供 DBMS 
(SQLServer, IBM DB2. Informix 或 Oracle) 。 
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2.2.3 ”可 选 扩 展 模块 


ArcGIS Server 中 还 有 一 系列 的 可 选 扩展 ， 可 用 来 补充 其 核心 系统 的 能 力 。 
1. ArcGIS Server Spatial 


ArcGIS Server Spatial 扩展 提供 一 套 强大 的 功能 ， 用 于 创建 、 查 询 和 分 析 基 于 像素 的 栅 格 数据 。 
在 ArcGIS Server 中 使 用 Spatial 扩展 可 以 从 现 有 数据 推导 出 有 价值 的 信息 、 确 认 空间 关系 、 找 到 适 
宜 位 置 、 计 算 旅行 代价 表面 以 及 执行 大 量 的 栅 格 地 理 处 理 操 作 。 用 ArcGIS Spatial Analyst 扩展 创 
建 的 模型 和 工具 可 以 利用 这 个 扩展 发 布 为 Web 服务 。 


2. ArcGIS Server 3D 


ArcGIS Server 3D 扩展 提供 了 一 套 3D GIS 功能 用 于 创建 和 分 析 表 面 。3D 扩展 添加 了 一 些 基 
T 3D 和 地 形 的 地 理 处 理 操作 ， 这 些 操作 可 以 发 布 为 Web 服务 。 


3. ArcGIS Ser ver Network 


ArcGIS Server Network 扩展 提供 基于 网 络 的 空间 分 析 能 力 ， 包 括 路 径 、 旅 行 方向 、 最 近 设施 
和 服务 区 域 分 析 。 开 发 人 员 可 以 使 用 它 构建 和 部 署 网 络 应 用 。 


4. ArcGIS Server Data Interoperability 


ArcGIS Server Data Interoperability 扩展 可 以 方便 使 用 和 分 发 不 同 格式 的 数据 。 使 用 Data 
Interoperability 扩展 可 以 直接 读 取 超 过 70 种 空间 数据 格式 ， 导 出 为 数 十 种 空间 数据 格式 。 使 用 
ArcToolbox 中 的 Quick Import Quick Export 工具 ， 可 以 在 各 种 数据 格式 之 间 快 速 转 换 。 使 用 
Workbench 的 语意 翻译 引擎 和 Spatial ETL 工具 ， 可 以 执行 高 级 的 数据 转换 。ETIL 

CExtract-Transform-Load). 是 用 于 转换 数据 的 工具 ， 它 可 以 在 多 种 计算 环境 间 轻 易 迁 移 。 使 用 
ArcGIS Data Interoperability 扩展 创建 的 特殊 格式 和 翻译 器 可 以 用 在 ArcGIS Server Web 服务 和 地 
理 处 理 服 务 中 ， 以 支持 自动 和 开放 的 数据 交换 。 


2.3 ArcGIS Server 9.2 系统 组 成 部 分 


ArcGIS Server 是 一 个 分 布 式 系统 ， 由 分 布 在 多 台 机 器 上 的 各 个 角色 协同 工作 。 基 于 ArcGIS 
Server 搭建 的 Web GIS 解决 方案 支持 多 种 类 型 的 客户 端 ， 包 括 ArcGIS 桌面 产品 、ArcGIS Engine 
应 用 与 Web 浏览 器 。 利 用 ArcGIS Server 搭建 的 Web GIS 架构 如 图 2.3 所 示 。 
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图 2.3 利用 ArcGIS Server 搭建 的 Web GIS 架构 
2.3.1 GIS 服务 器 


GIS Server 宿主 了 所 有 的 GIS 的 资源 ， 比 如 地 图 、3 维 场景 等 ， 并 且 把 它们 作为 服务 发 布 到 客 
户 端 。 
GIS Server 本 身 包 含 了 两 个 部 分 ，SOM (Server Object Manager， 服 务 器 对 象 管理 器 ) 和 SOCs 
(Server Object Containers， 服 务 器 对 象 容器 ) 。SOM 管理 着 运行 在 服务 器 上 的 服务 ， 当 客户 端 请 
求 一 个 服务 的 时 候 ，SOM 负责 分 配 一 个 服务 给 客户 端 使 用 ， 它 起 到 一 个 负载 均衡 的 作用 ， 一 个 管 
理 服务 的 作用 。 SOM 连接 着 一 个 或 者 多 个 SOC， 真 正 的 服务 都 是 在 SOC 的 机 器 上 运行 着 的 ， 也 
就 是 说 SOC 才 是 真正 的 服务 的 宿主 ， 所 有 的 客户 端的 请 求 通过 SOM 分 配 以 后 都 是 由 某 个 SOC 来 
负责 完成 的 。 当 然 根 据 配置 的 不 同 ，SOM 和 SOC 可 以 分 配 到 不 同 的 机 器 上 ， 也 可 以 由 多 个 SOC 
的 机 器 ， 图 2.3 即 显示 的 是 一 个 SOM 机 器 连接 着 三 个 SOC 机 器 。 


2.32 Web 服务 器 


Web 服务 器 是 运行 Web 应 用 程序 或 Web Service 的 机 器 。 这 里 的 Web 应 用 程序 或 Web Service 
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通过 访问 GIS Server 并 调用 GIS Server 的 对 象 来 实现 GIS 功能 ， 然 后 把 结果 返回 给 客户 端 。 
233 客户 端 


通过 Http 方式 或 者 局 域 网 方式 连接 到 ArcGIS Server 的 各 种 客户 端 : 浏览 器 ，C/S 程序 或 者 移 
动 设备 等 。 


2.3.4 数据 服务 器 


包含 GIS Server 上 所 发 布 服务 的 GIS 资源 ， 可 以 是 mxd 文档 、geodatabase、toolbox 等 。 
2.3.5 管理 工具 


Manager 和 ArcCatalog 是 ArcGIS Server 的 管理 工具 , 可 以 使 用 这 两 个 工具 来 进行 服务 的 发 布 ， 
开始 停止 等 操作 。Manager 是 一 个 web 应 用 ， 支 持 发 布 服务 ， 管 理 GIS Server， 创 建 Web 应 用 ， 
以 及 发 布 3D 服务 等 。ArcCatalog 包含 了 一 个 GIS Servers 的 节点 ， 可 以 用 来 连接 和 管理 某 个 GIS 


Server。 


2.36 ”地 图 内 容 制作 工具 


ArcGIS 桌面 软件 是 GIS 资源 的 编辑 和 制作 工具 , 通过 ArcGIS Server 发 布 的 各 种 资源 都 可 以 通 
过 ArcGIS 桌面 软件 进行 制作 ， 比 如 地 图 (mxd 文件 ) ，Geoprocessing 工具 , 三 维 场景 (3dd 文件 ) ， 
都 可 以 通过 ArcMap, ArcCatalog, ArcGlobe 等 应 用 程序 来 进行 制作 。 如 果 需 要 为 地 图 服务 生成 组 
存 ， 可 以 用 ArcCatalog 来 创建 。 


2.4 ArcGIS Server 包含 的 主要 技术 


ArcGIS Server 包含 的 主要 技术 包括 ArcSDE HR, Web 地 图 应 用 和 ArcGIS Mobile 技术 。 
2.4.4 ArcSDE 


企业 级 GIS 是 一 个 一 体 化 的 ， 多 部 门 的 系统 ， 既 要 满足 组 织 内 部 单一 的 要 求 ， 又 要 满足 综合 

的 需要 ， 为 GIS 和 非 GIS 人 员 访 问 地 理 信息 和 服务 提供 条 件 。 数 据 服 务 器 包含 了 要 发 布 为 服务 的 
GIS 资源 。 对 于 大 多 数 GIS 服务 器 ， 这 些 资 源 通过 ArcSDE 管理 在 基于 关系 型 数据 库 的 地 理 数 据 库 
(geodatabase) 中 。 在 任何 一 个 ArcGIS Server 的 应 用 系统 中 ， 为 了 满足 这 种 企业 级 需求 ， 基 于 
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ArcSDE 技术 的 长 事务 处 理 的 多 用 户 geodatabase 都 是 至 关 重 要 的 。 因 此 ESRI 将 ArcSDE 技术 纳入 
ArcGIS Server 体系 。 
ArcSDE 的 优势 和 功能 包括 : 
高 效率 和 系统 可 伸缩 行 ; 
与 开 系统 集成 ; 
发 生 冲 突 时 的 协调 更 新 机 制 ; 
数据 库 复制 ; 
历史 归档 ; 
版 本 和 非 版 本 编辑 ; 
支持 跨 平 台 和 跨 数据 库 ; 
支持 直接 通过 SQL 访问 Oracle, IBM DB2 和 Informix geodatabase。 


ArcGIS Server 是 一 个 用 于 高 级 GIS 应 用 的 集中 管理 的 GIS。 它 可 以 让 开发 者 和 系统 设计 员 实 
现 一 个 集中 的 GIS， 支 持 多 用 户 访问 。 集 中 的 GIS 应 用 (如 Web 应 用 ) 能 够 减少 在 每 台 机 器 上 安 
装 和 管理 桌面 应 用 的 费用 。ArcGIS Server 的 提供 Web 服务 的 能 力 ， 使 得 GIS 能 够 与 其 他 的 IT 系 
统 有 效 集成 ， 如 关系 数据 库 、Web 服务 器 、 以 及 企业 应 用 服务 器 。 

所 有 级 别 的 ArcGIS Server 产品 都 包含 了 ArcSDE 技术 。 

ArcGIS Server 工作 组 级 含有 支持 SQL Server Express 的 ArcSDE。 使 用 这 个 级 别 的 ArcGIS 
Server， 人 允许 10 个 并 发 桌面 用 户 和 编辑 人 员 (例如 ArcView、ArcEditor、ArcInfo、 ArcGIS Engine 
应 用 、AutoCAD 和 MicroStation 用 户 ) 加 上 任意 数量 的 服务 器 连接 使 用 SQL Server Express。SQL 
Server Express 是 包含 在 ArcGIS Server 工作 组 级 中 的 一 部 分 。 它 限制 运行 于 1CPU 或 core, 最 大 1GB 
的 内 存 。 数 据 库 大 小 最 大 为 4GB。 管 理 员 可 以 使 用 ArcEditor 或 ArcInfo 来 创建 、 管 理 和 维护 工作 
组 级 ArcSD geodatabase. 可 以 在 ArcCatalog 中 使 用 SQL Server Express 来 设置 和 管理 工作 组 ArcSD 
geodatabase， 无 需 额 外 的 数据 库 管理 知识 。 

ArcGIS Server 企业 级 包含 企业 级 ArcSDE 技术 ， 这 是 传统 的 ArcSDE 技术 ， 它 运行 于 Oracle、 
SQL Server, IBM DB2 和 IBM Informix 数据 库 之 上 ， 人 允许 任意 大 小 的 数据 库 、 任 意 数量 的 用 户 ， 
可 以 运行 在 任意 配置 的 电脑 上 。 使 用 ArcGIS Server 企业 级 , 用 户 需要 自己 提供 DBMS 许可 .DBMS 
通常 由 数据 库 管理 员 (DBA) 管 理 和 维护 。 企业 级 ArcSDE 技术 支持 运行 在 跨 平 台 上 的 Oracle; IBM 
DB2 和 Informix， 和 Window 服务 器 上 的 SQL Server。 
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2.4.0 Web 地 图 应 用 


ArcGIS Server 包含 一 个 即 拿 即 用 的 Web 地 图 应 用 , 可 以 直接 运行 在 Web 浏览 器 中 。 该 客户 端 
为 使 用 ArcGIS Server 和 其 他 服务 提供 了 丰富 的 用 户 体验 。 这 个 Web 地 图 应 用 同时 也 作为 ArcIMS 
92 的 一 部 分 。Web 地 图 应 用 支持 合 加 多 种 类 型 的 地 图 服务 ， 如 来 自 于 ArcIMS, ArcGIS Server, 
OGC 的 WMS 以 及 ESRI 发 布 的 ArcWeb 服务 。 

Web 地 图 应 用 提供 的 工具 有 : 
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交互 的 内 容 表 ; 

平滑 的 地 图 浏览 ， 平 移 和 缩放 工具 ; 

地 图 提示 和 要 素 查询 功能 

空间 查询 和 选择 工具 ; 

基于 Web 的 ArcSDE geodatabase 编辑 功能 ( 包括 添加 要 素 ， 切 分 ， 捕 捉 ， 要 素 修整 和 属 
性 编辑 ) ; 

ArcGIS Server 管理 器 提供 方便 的 配置 能 力 ， 不 需要 编程 ; 

为 .NET 和 Java 开发 者 提供 强大 的 开发 环境 支持 ， 提 供 一 组 可 定制 的 编程 控件 和 组 件 ; 
基于 标准 和 开发 性 ; 

Web 地 图 应 用 框架 基于 Ajax 技术 ， 大 大 增强 了 用 户 体验 ， 它 支持 用 户 在 交互 使 用 Web 
应 用 的 同时 ， 应 用 程序 与 其 他 资源 (如 Web 服务 器 ) 进行 通讯 。 


DOODD 


DOCU 


24.3 ArcGIS Mobile 


ArcGIS Server 为 移动 用 户 提供 了 名 为 ArcGIS Mobile 的 Web 应 用 开发 框架 ， 用 于 创建 和 部 属 
面向 移动 的 解决 方案 ， 其 特点 是 应 用 在 “ 非 实时 连接 ”环境 且 面 对 大 量 用 户 。 这 些 应 用 为 运行 
Microsoft Windows Mobile 的 野外 设备 提供 移动 地 图 ，GPS, 无 线 步 以 及 GIS 数据 复制 和 编辑 功能 。 
ArcGIS Mobile 支持 在 线 和 离线 工作 流 环 境 中 编辑 版 本 化 的 ArcSDE geodatabase。 可 以 不 用 返回 办 
公 室 , 就 可 以 通过 ArcGIS Server 定期 进行 更 新 同步 -ArcGIS Mobile 可 以 运行 在 大 量 的 移动 设备 上 : 
智能 手机 、Pocket PC 和 Tablet PC。 


2.5 ArcGIS Server 9.2 安装 


ArcGIS Server 9.2 产品 包括 两 个 部 分 ， 一 是 GIS Server， 它 是 一 个 提供 GIS 服务 的 服务 器 软件 
产品 ， 包 括 一 系列 核心 AO 库 和 一 个 管理 这 些 AO 组 件 的 可 缩放 的 运行 环境 ， 另 一 个 是 ADF, Hl 
应 用 程序 开发 框架 ， 它 有 JAVA 和 .NET 两 种 开发 组 件 集 ， 它 是 用 来 开发 和 部 署 基 于 GIS Server 的 
Web 应 用 程序 的 产品 ， 包 括 组 件 对 象 、Web 控件 、Web 模板 和 开发 帮助 ， 它 还 有 一 个 Web 程序 的 
运行 时 (Runtime) ， 专 门 用 于 发 布 和 部 署 使 用 ADF 开发 的 Web 程序 ， 如 ASP.NET 等 。 

GIS Server 是 一 套 GIS 服务 器 组 件 ， 专 门 用 于 管理 和 发 布地 图 服务 和 定位 服务 ， 安 装 在 GIS 
服务 器 上 ; ADF 是 供 开 发 人 员 使 用 的 开发 组 件 集 ， 安 装 在 开发 人 员 的 机 器 上 ， 这 些 程序 包括 Web 
应 用 程序 、Web 服务 和 桌面 端 程序 ， 都 可 以 使 用 ADF; ADF 运行 时 是 专门 用 于 部 署 开发 人 员 开 发 
的 GIS Web 程序 和 GIS Web Service 的 工具 ， 安 装 在 Web 服务 器 上 。GIS 服务 器 、Web 服务 器 和 
开发 人 员 的 电脑 可 以 是 同一 台 机 器 ， 也 可 以 分 开 安装 。 


2.5.1 ArcGIS Server 安装 概述 


ArcGIS Server 安装 过 程 包括 两 个 部 分 : 安装 (installation) 和 安装 后 (post installation) 设置 。 


h 
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为 了 完成 ArcGIS Server 的 安装 ， 需 要 使 用 Windows 操作 系统 工具 手动 设置 一 些 步骤 。 


(1) 安装 过 程 需 要 用 户 决 定安 装 哪些 功能 部 件 ， 安 装 程序 将 安装 选择 的 部 件 所 需要 的 文件 。 

(2) 后 安装 是 用 来 完成 ArcGIS Server 安装 过 程 的 。 在 后 安装 过 程 中 ， 依 赖 于 选择 安装 的 部 
件 ,将 能 够 配置 ArcGIS Server 和 授权 ArcGIS Server。 配 置 ArcGIS Server 选项 将 设置 需要 的 ArcGIS 
Server 账号 。 授 权 ArcGIS Server 选项 将 授权 ArcGIS Server 的 使 用 。 


安装 ArcGIS Server 9.2 之 前 必须 外 载 版 本 是 9.2 之 前 的 以 下 产品 : ArcGIS Desktop. ArcInfo 
Workstation, ArcReader standalone、ArcIMS， 否 则 将 出 现 冲 突 ， 不 能 安装 。 如 果 是 9.2 版 本 ， 则 不 


2.5.2 Æ ArcGIS Server for .NET 


安装 ArcGIS Server 之 前 ， 必 须 确保 满足 以 下 几 个 条 件 : 


获取 ArcGIS Server 的 授权 文件 ; 

确认 机 器 ( 和 操作 系统 等 ) 满足 软件 安装 要 求 ; 

以 具有 管理 员 权限 的 账号 登录 操作 系统 ; 

确保 temp 变量 被 设置 为 一 个 有 效 的 目录 ， 并 具有 写 的 权限 和 可 用 空间 ; 
确保 先 安装 Visual Studio 2005。 


D0000 


=% 


Z% (Installation) 


在 光驱 中 插入 安装 盘 ， 点 击 setup.exe， 安 装 程序 将 自动 开始 安装 。 

在 安装 过 程 中 , 安装 进程 将 允许 选择 所 需要 安装 的 部 件 (如 图 2.4 所 示 )。 如 果 需 要 将 GIS Server 
与 应 用 程序 开发 框架 安装 在 同一 台 机 器 上 ， 则 需要 同时 选择 GIS Server 与 Web Application 
Developer Framework， 如 果 需 要 分 开 安装 ， 则 可 只 选择 其 中 一 个 。Web Application 用 于 在 Web 服 
务 器 上 部 署 一 管理 GIS Server 的 Web 应 用 程序 。Mobile Application Developer Framework 则 是 用 于 
创建 移动 应 用 程序 所 需要 的 框架 。 

在 安装 ArcGIS Server 时 , 其 安装 目录 取决 于 第 一 次 安装 ArcGIS 产品 的 目录 。 比 如 第 一 次 在 D 
得 安装 了 ArcGIS Desktop， 那 么 下 次 安装 ArcGIS 产品 时 将 默认 安装 在 D 盘 。 因 此 ， 必 须 保证 安装 
目录 有 足够 的 空间 。 

根据 提示 ， 点 击 Next， 完 成 安装 。 当 完成 了 ArcGIS Server 安装 后 ， 将 进行 后 安装 。 


S19 qa 从 


fF LN 
E b Web GIS 开发 一 一 ArcGIS Server 与 NET 


iB ArcGIS Server for the Nicrosoft -NET Framework ... [E 


Select Features 


Please select which features you would ike to install 


Feature Description: 
The GIS Server is comprised of the Server. 
Dbiect Manager and Server Object Container. 


The festre wl be etaled on the local hard 
S] Viua Studo [ogres 392KB on you hard dive. 

X -| Mobile Application Developer Fr: etre meena 

subleahures requre 51 


RB on por had dive. 
< > 


C:\Program Fles\AIcGIS\ 


Hep | ( Disk Cost 


图 2.4 ArcGIS Server 安装 选项 
2. 后 安装 (Post Installation) 


使 用 ArcGIS Server 必须 完成 安装 后 设置 。 可 以 在 初始 安装 时 完成 安装 后 设置 或 是 在 稍 后 运行 
安装 后 设置 (开始 程序 | ArcGIS | ArcGIS Server | ArcGIS Server Post Installation). 。 


CD) 进入 GIS Server Post Install 对 话 框 ， 在 对 话 框 中 有 两 个 安装 选项 ， 分 别 是 配置 ArcGIS 


Server 和 认证 ArcGIS Server， 如 图 2.5 所 示 。 如 果 是 安装 服务 器 对 象 容器 CSOCO ， 则 两 个 选项 都 
必须 被 包括 。 


"rver Post Install 


Yelcome to the GIS Server Post Install 
Select fron the following options 


Hae donee specify the user accounts necessary to run the GIS Server on this 
machine. It wil create these user 


accounts if necessary, and grant them the necessary 
privileges on the system. It wil also create the GIS Server user groups. 


Iv [Configure GIS S: 
Select his option to configure the GIS Server for use. 


IV. Authorize GIS Server. 


Select this option to authorize the GIS Server for use. 


图 2.5 后 安装 选项 


(2) 选择 “下 一 步 ”， 进 入 配置 ArcGIS Server 选项 对 话 框 ， 如 图 2.6 所 示 。 
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Specify the s that the Server Object Manager (SOM) end the. 
Server Object Container (SOC) processes wi 11 run as 


(€ Épeciiy the account names and passwords 
SOM Account: [ArcGISSOM 


BRE 
-一 一 一 一 
-一 一 一 


~ l have a configuration file with the account information generated by a previous run of this 
selup. 
Filename 
《上 一 步 @@) 取消 Eh 


图 2.6 指定 GIS Server 账号 与 密码 


(3) 配置 ArcGIS Server 选项 将 设置 ArcGIS Server 账号 。 指 定 ArcGIS Server 账号 和 密码 ， 以 
及 ArcGIS Container 账号 和 密码 。ArcGIS Server 账号 运行 服务 器 对 象 管理 器 (SOM) 服务 和 进程 。 
这 个 进程 管理 容器 机 器 上 的 容器 进程 ， 并 且 管 理 ArcGIS Server 的 配置 日 志文 件 。ArcGIS 容器 账号 
是 容器 进程 管理 服务 器 对 象 的 账号 。 容 器 进程 是 由 服务 器 对 象 管理 器 (SOM) 启动 的 ， 但 是 是 作 
为 ArcGIS 容器 账号 运行 的 。ArcGIS 服务 器 账号 和 ArcGIS 容器 账号 能 够 是 本 地 账号 或 是 域 账号 。 
推荐 用 本 地 账号 。 如 果 本 地 账号 不 存在 ， 安 装 后 设置 将 会 创建 它 。 如 果 指 定 域 账号 ， 这 些 账 号 必须 
是 已 经 存在 的 。 

(4) 设置 ArcGIS SOM 用 户 和 ArcGIS SOC 用 户 的 密码 后 ， 选 择 “下 一 步 ”， 进 入 “设置 
Webservices 账号 ”对 话 框 。Webservices 账号 用 于 Web 服务 器 连接 GIS 服务 器 ， 以 处 理 Web 服务 
请 求 。 设 置 好 账号 与 密码 后 ， 选 择 “ 下 一 步 ”， 进 入 “指定 GIS Server 目录 ”对 话 框 。 保 持 默 认 选 
项 , 进入 代理 服务 器 的 设置 。 同 样 保持 默认 选项 ， 即 不 使 用 代理 服务 器 。 选择“ 下 一 步 ”, 进入 “ 输 
出 服务 器 配置 文件 选项 ”对 话 框 ， 默 认 选择 ， 进 入 下 一 个 对 话 框 ， 选 择 Install 按钮 来 安装 。 

(5) 当 配 置 ArcGIS Server 以 后 ， 后 安装 程序 进入 认证 向 导 。 认 证 向 导 的 第 一 个 对 话 框 是 注 
册 选 项 ， 选 择 其 中 的 第 三 个 ， 即 已 有 认证 文件 ， 进 入 下 一 步 。 输 入 认证 文件 所 在 路 径 后 ， 选 择 “ 下 
一 步 ”， 对 话 框 中 将 列 出 被 授权 的 功能 。 


至 此 安装 完成 ， 但 是 配置 任务 并 没有 结束 ， 还 需要 配置 组 账户 。 

GIS Server 安装 后 , 在 计算 机 上 创建 了 两 个 本 地 组 账户 , 分 别 是 agsadmin 与 agsusers。 agsadmin 
组 中 的 用 户 将 可 以 拥有 管理 GIS Server 的 权限 ,agsusers 组 中 的 用 户 将 拥有 使 用 GIS Server 的 权限 。 

将 自己 最 常用 的 账户 (通常 是 Administrator) 加 入 到 这 两 个 组 中 。 设 置 完 以 后 ， 需 要 重新 启动 
计算 机 或 注销 用 户 一 次 。 


ArcGIS Server 管 理 与 服务 发 布 - 


一 个 GIS 服务 器 可 发 布 多 种 类 型 的 GIS 服务 。 一 个 GIS 服务 代表 一 个 GIS 资源 , 例如 二 
维 地 图 、 三 维 地 图 、 地 理 编码 或 空间 数据 库 连 接 等 。 客 户 端 应 用 程序 在 服务 器 上 查找 这 些 服 
务 后 ， 便 可 访问 这 些 服 务 。 通 过 服务 的 方式 简化 了 在 不 同 客户 端 共 同 享用 资源 ， 例 如 可 以 确 
保 每 个 客户 端 显示 的 资源 是 一 致 的 ， 而 且 由 于 只 需要 在 服务 器 上 存储 资源 ， 不 需要 在 客户 端 
安装 GIS 软件 ， 因 此 可 节约 费用 。 一 切 的 功能 都 在 服务 器 上 完成 ， 包 括 存储 资源 ,发 布 服务 ， 
进行 GIS 运算 ,将 结果 以 常用 的 格式 (图 片 或 文本 ) 发 送 给 客户 端 。 

ArcGIS Server 可 发 布 多 种 服务 ， 包 括 地 图 服务 、 地 理 编码 服务 、 网 络 分 析 服 务 、 空 间 处 
理 服 务 等 ， 这 些 服务 的 发 布 与 管理 可 以 通过 Manager 应 用 或 ArcCatalog 应 用 来 完成 。 然 而 在 
发 布 这 些 服 务 之 前 , 需要 利用 桌面 产品 进行 创建 和 准备 这 些 服 务 使 用 的 资源 , 例如 md 文件 、 
3dd 文件 等 。 

本 章 将 介绍 : 


3.1 管理 ArcGIS Server 


32 ”发布 服务 
33 配置 文件 的 使 用 
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3.1 管理 ArcGIS Server 


用 户 可 以 登录 到 Manager 或 者 是 在 ArcCatalog 中 创建 管理 的 连接 来 对 GIS Server 进行 管理 ， 
首先 一 个 必须 要 做 的 是 添加 相应 的 ArcSOC 的 机 器 。 在 用 户 的 整个 系统 配置 中 , 肯定 有 一 台 或 者 多 
台 的 ArcSOC 机 器 ， 所 以 需要 在 Server 属性 中 进行 添加 ， 如 果 把 ArcGIS Server 只 是 安装 在 一 台 机 
器 上 ， 那 么 就 把 本 机 作为 ArcSOC 的 机 器 即 可 。 


3.1.1 使 用 Manager 管理 ArcGIS Server 


要 使 用 Manager 来 管理 ArcGIS Server， 需 要 在 安装 ArcGIS Server 时 选择 安装 此 工具 。 然 后 需 
要 将 一 个 账户 (我 们 这 里 以 Administrator 为 例 ) 加 入 到 agsadmin 组 中 。 
Manager 工具 是 一 Web 应 用 程序 。 这 就 意味 着 可 以 从 其 他 计算 机 通过 浏览 器 远程 管理 ArcGIS 


Server。 


1. 登录 Manager 


从 安装 了 ArcGIS Server 计算 机 上 选择 “开始 | 程序 | ArcGIS | ArcGIS Server for the 
Microsoft .NET Framework | ArcGIS Server Manager”, 或 从 其 他 计算 机 的 浏览 器 中 输入 如 下 格式 的 
地 址 http://192.168.2.245/ArcGIS/Manager/login.aspx (其 中 192.168.2.245 是 笔者 试验 用 的 GIS 服务 
器 的 IP 地址 ， 请 换 成 读者 自己 计算 机 的 他 地址， ， 将 打开 如 图 3.1 所 示 的 登录 界面 。 


文件 FE) SEO FEV 收藏 IAW 帮助 0 
Hil D) [E] hetp: //1ocaLhost/ArcGIS/Wanager/1ogin. aspx?Returnlir1-X2fArcGISs2Q | E] 639 
LZ is ArcGIS SERVER MANAGER. 

G 人 Al 


User name: !GC.D830-1MAdministrator] 
E 


xample: DomainUserName 


Password: 


ArcGIS server: 


图 3.1 ArcGIS Server Manager 登录 界面 


在 该 登录 界面 的 用 户 名 中 需要 输入 “域名 \ 用 户 名 ”， 如 果 没 有 使 用 域 ， 那 么 域名 就 是 GIS 服 
务 的 计算 机 名 ， 也 就 是 该 界面 中 第 三 个 文本 框 中 的 名 称 。 而 这 个 名 称 在 登录 界面 中 是 不 能 更 改 的 ， 
这 是 因为 Manager 工具 直接 与 ArcGIS Server 的 一 个 实例 相关 。 只 能 用 Manager 工具 登录 一 个 GIS 
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服务 器 。 
2. 服务 对 象 容器 管理 


当 第 一 次 连接 GIS 服务 器 后 , 需要 在 服务 器 上 增加 一 个 或 多 个 服务 对 象 容器 , 或 SOC 计算 机 。 
SOC 可 以 装 在 多 台 机 器 上 ， 是 服务 对 象 的 宿主 。 每 一 台 SOC 机 器 可 以 产生 多 个 容器 进程 ， 一 个 容 
器 进程 可 以 运行 多 个 服务 对 象 。 为 了 让 GIS 服务 器 能 够 利用 这 些 SOC 计算 机 ， 需 要 利用 服务 对 象 
管理 器 SOM 连接 它们 。 

要 让 一 计算 机 作为 SOC， 需 要 在 安装 ArcGIS Server 时 选择 安装 “Server Object Container”。 
此 外 ， 还 需要 在 后 安装 时 指定 与 ArcGIS Server 相同 的 SOM 与 SOC 账号 与 密码 。 

当然 如 果 在 一 服务 器 上 既 安装 了 SOM 又 安装 了 SOC， 而 没有 其 他 SOC 计算 机 ， 那 么 就 没有 
必要 添加 SOC. 

要 添加 服务 对 象 容器 计算 机 , 需要 在 Manager 工具 中 选择 GIS Server 标签 , 然后 选择 Add Host 
Machine， 输 入 计算 机 名 称 后 ， 便 可 添加 。 


3. 服务 器 路 径 管理 


服务 器 路 径 就 是 网 络 上 的 一 个 物理 路 径 ， 该 路 径 可 以 被 所 有 容器 计算 机 访问 。 当 需要 时 ，GIS 
服务 器 在 这 些 路 径 中 保存 临时 文件 。 服 务 器 会 根据 用 户 指定 的 间隔 时 间 定期 清除 服务 器 路 径 中 的 文 
件 。 

服务 器 路 径 可 分 三 类 ， 分 别 是 缓存 、 任 务 与 输出 。 


O ”缓存 路 径 是 为 了 加 快 显示 速度 ， 存 储 了 地 图 服务 的 预 描绘 地 图 块 。 要 创建 地 图 缓存 ， 必 
须 使 用 ArcCatalog，Manager 工具 不 能 创建 。 

O ”任务 路 径 存储 了 空间 处 理 服务 需 要 的 文件 。 通 常 ， 空 间 处 理 服 务 需 要 一 定 的 空间 来 保存 
临时 文件 与 存储 后 续 工作 的 信息 。 

口 ”输出 路 径 通常 用 于 服务 器 保存 临时 文件 。 空 间 处 理 服务 必须 有 输出 路 径 ， 空 间 数据 服务 
推荐 使 用 输出 路 径 ， 对 于 地 图 服务 ， 输 出 路 径 则 是 一 可 选项 ， 而 对 于 其 他 服务 ， 则 不 需 


要 输出 路 径 。 
在 ArcGIS Server 的 后 安装 过 程 中 ， 在 指定 的 位 置 默 认为 每 一 个 类 型 创建 了 一 路 径 。 默 认 路 径 
为 ci\arcgisserver。 


可 以 通过 Manager 工具 的 GIS Server 标签 中 的 Directories 来 管理 服务 器 路 径 , 包括 新 加 、 删 除 
与 编辑 。 


4. 日 志文 件 位 置 


ArcGIS Server 将 系统 消息 记录 在 日 志文 件 中 。 当 怀疑 服务 器 工作 不 对 时 ， 可 通过 检查 日 志文 
件 来 查看 服务 器 运行 情况 。 

默认 的 日 志文 件 在 ArcGIS Server 安装 目录 中 的 Server\user\log 路 径 中 , 当然 可 以 通过 Manager 
来 指定 日 志文 件 的 路 径 。 

如 果 ArcGIS Server 配置 的 是 分 布 式 安装 ， 即 服务 对 象 运行 在 多 台 计 算 机 上 ， 那 么 需要 共享 该 
日 志 路 径 ， 并 使 用 一 UNC 路 径 〈 例 如 \myServerlog) 引用 。 还 需要 确保 SOM 与 SOC 账号 对 该 路 
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径 有 读 写 权限 。 
5. 设置 服务 对 象 容器 的 能 力 


通过 设置 服务 对 象 容器 的 能 力 属性 ， 可 控制 每 一 个 服务 对 象 容器 计算 机 可 运行 多 少 个 服务 实 
例 。 如果 一 台 服 务 对 象 容器 计算 机 的 性 能 大 大 高 于 其 他 计算 机 , 这 时 可 将 该 计算 机 的 功能 值 设 置 大 


只 


要 设置 服务 对 象 容器 的 能 力 ， 在 Manager 工具 中 选择 GIS Server 标签 ， 在 左边 的 菜单 中 选择 
Host Machines (SOC) ， 然 后 在 需要 设置 能 力 的 计算 机 旁 选择 Edit 连接 ， 然 后 在 Capacity 文本 框 
中 输入 一 理想 的 数值 。 默 认 值 为 -1， 表 示 无 限制 能 力 。 最 后 选择 Update 来 保存 设置 。 


3.1.2 ”使 用 ArcCatalog 管理 ArcGIS Server 


可 以 将 ArcCatalog 想象 为 ArcGIS Server 的 一 个 用 户 界面 。 通 过 ArcCatalog， 可 以 查看 或 管理 
(如 果 是 管理 员 ) 服务 器 上 运行 的 服务 的 设置 。ArcCatalog 为 GIS 服务 器 提供 两 个 不 同 的 界面 ， 一 
个 供 管理 员 用 ， 另 一 个 供 普通 使 用 者 使 用 。 
当 作为 普通 用 户 连接 GIS 服务 器 后 , ArcCatalog 只 简单 地 列 出 该 用 户 可 使 用 的 服务 。 该 用 户 可 
使 用 这 些 服 务 ， 例 如 在 ArcMap 中 显示 服务 器 中 的 地 图 ， 但 是 不 能 管理 这 些 服务 ， 例 如 删除 。 当 作 
为 管理 员 连 接 时 ， 可 看 到 一 些 额外 的 工具 允许 管理 服务 。 这 时 可 以 通过 ArcCatalog 管理 运行 在 服 
务 器 上 的 服务 以 及 该 服务 器 所 包含 的 一 组 计算 机 , 可 以 监视 客户 端 应 用 程序 如 何 使 用 每 一 个 单独 的 
服务 ， 以 及 是 否 有 足够 的 资源 满足 客户 端 需求 。 可 能 常常 需要 为 某 一 特定 的 服务 增加 计算 机 资源 ， 
有 时 还 可 能 需要 增加 额外 的 计算 机 来 分 担负 载 。 


1. 连接 GIS 服务 器 
ArcCatalog 提供 了 两 种 连接 GIS 服务 器 的 选择 ， 一 是 管理 员 连 接 ， 另 一 是 普通 用 户 连接 。 


(1) 管理 员 连 接 

启动 ArcCatalog 后 , 在 目录 树 中 双击 GIS Servers, 然后 双击 Add ArcGIS Server, 在 随后 的 Add 
ArcGIS Server 向 导 的 第 一 个 页 面 中 选择 Manage GIS Services， 然 后 进入 General 页 面 ， 如 图 3.2 所 
不 。 

在 该 页 面 的 Server URL 中 ， 输 入 需要 连接 的 ArcGIS Server 实例 的 URL。 该 URL 的 格式 为 

“http://< 服 务 器 名 称 或 IP 地 址 >/< 实 例 名 >/services”， 实 例 名 是 在 后 安装 过 程 中 指定 的 ， 默 认为 

arcgis ， 例 如 连接 笔者 的 GIS 服务 器 的 URL 为 http:/ BGC D$830-l/arcgis/services 或 为 
http://192.168.2.245/arcgis/services。 对 于 Host Name， 需 要 输入 的 是 服务 器 的 计算 机 名 称 。 如 果 GIS 
服务 器 包含 了 几 台 计算 机 ， 那么 这 里 需要 指定 的 是 运行 服务 对 象 管理 器 的 计算 机 。 输入 完成 后 , 选 
择 Finish， 即 可 在 目录 树 中 见 到 服务 器 。 
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General 


Server URL: [http://BGC. D830-1/ rcgi s/ services 


http://www. nyserver. con/arcgis/services 


Most Name: [BGC D830-1| 


图 3.2 管理 员 连 接 界 面 


(2) 普通 用 户 连接 

以 普通 用 户 连接 时 ， 只 能 查看 与 使 用 服务 器 上 的 服务 ， 不 能 编辑 服务 的 属性 ， 也 不 能 增加 、 删 
除 、 启 动 、 停 止 或 暂停 服务 。 当 使 用 普通 用 户 连接 时 ， 可 选择 是 连接 到 局 域 网 中 的 本 地 服务 器 ， 还 
是 广域网 中 的 远程 服务 器 。 当 使 用 局 域 网 连接 时 ， 必 须 使 用 服务 器 中 agsusers 用 户 组 中 的 用 户 运 行 
ArcCatalog. 

需要 以 某 个 用 户 的 身份 来 运行 ArcCataleg 时 ， 可 以 通过 “属性 ”中 的 “快捷 方式 ”选项 卡 中 
“高 级 ”按钮 ， 设 置 为 “以 其 他 用 户 身份 运行 ”。 也 可 以 用 命令 行 启 动 ArcCatalog， 到 ArcGIS 安 
装 目录 下 输入 : runas /user:*** arccatalog， 而 不 用 切换 用 户 。 

以 普通 用 户 身份 连接 的 步骤 如 下 : 


CD 启动 ArcCatalog 后 ， 在 目录 树 中 双击 GIS Servers， 然 后 双击 Add ArcGIS Server， 在 随后 的 
Add ArcGIS Server 向 导 的 第 一 个 页 面 中 选择 Use GIS Services， 然 后 进入 General 页 面 ， 如 图 3.3 所 示 。 


Choose the type of ArcGIS Server connection 


[pctp://192. 168.2. 245/ rcgi s/ services 


http://www. nyserver. con/arcgis/services 


[7 Save Usernane/Password 


csoma] ma 


图 3.3 以 普通 用 户 身份 连接 界面 
(2) 首先 选择 连接 方式 。 如 果 要 通过 广域网 连接 ， 选 择 Intemet， 并 输入 服务 器 的 URL， 该 
URL 的 格式 为 “http://< 服 务 器 名 称 或 IP. 地 址 >/< 实 例 名 >/services”， 实 例 名 是 在 后 安装 过 程 中 指 
定 的 ， 默 认为 arcgis， 例 如 连接 笔者 的 GIS 服务 器 的 URL 为 http:// BGC_D830-1 /arcgis/services 或 
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为 http://192.168.2.245/arcgis/services。 
GO 如 果 服 务 器 不 允许 匿名 连接 ， 那 么 还 需要 输入 用 户 名 与 口令 。 如 果 要 连接 的 是 局 域 网 中 
的 服务 器 ， 则 选择 Local， 并 输入 服务 器 的 计算 机 名 称 即 可 。 


2. 管理 服务 对 象 容器 
使 用 ArcCatalog 管理 服务 对 象 容器 的 方法 如 下 : 


以 管理 员 连 接 方式 连接 服务 器 ， 然 后 在 ArcCatalog 的 目录 树 中 ， 右 击 GIS 服务 器 名 称 ， 选 择 
上 下 文 菜单 中 的 Server Properties 项 。 在 弹出 的 “ArcGIS 服务 器 属性 ”对 话 框 中 选择 Hosts 标签 ， 
进入 该 标签 页 。 在 该 标签 页 中 选择 Add 按钮 ， 弹 出 Add Machine 对 话 框 ， 如 图 3.4 所 示 。 输 入 服务 
对 象 容器 计算 机 的 名 称 ， 或 利用 浏览 按钮 选择 一 台 计 算 机 。 


Gener Hosts | Directories | Statistics | Types | 


The ist below shows the machines avalable to host server objects. 
NOTE: you need to add at least one machine lo use the server 


图 3.4 利用 ArcCatalog 增加 服务 对 象 容器 


利用 ArcCatalog 的 ArcGIS Server Properties 对 话 框 也 能 管理 服务 器 路 径 、 日 志文 件 以 及 服务 对 
象 容器 能 力 ， 操 作 方 法 很 简单 ， 这 里 为 节省 篇 幅 ， 不 再 痪 述 。 


3.2 RARA 


在 ArcGIS Server 中 发 布 的 资源 是 通过 桌面 产品 进行 创建 和 准备 的 ， 比 如 mxd 文件 ， 比 如 3dd 
文件 等 ,因此 在 发 布 服务 之 前 要 准备 好 这 些 数据 ,并 使 得 agsusers 组 中 的 用 户 可 以 有 权限 访问 到 这 
些 数据 。 发 布 服 务 的 功能 在 Manager 应 用 以 及 Arccatalog 中 都 可 以 完成 。 


3.2.1 服务 与 功能 


HE GIS 服务 器 上 将 一 个 GIS 资源 发 布 为 服务 时 ， 可 以 指定 该 服务 包含 的 功能 。 功 能 即 客户 
使 用 该 服务 的 方法 , 例如 地 图 服务 最 基本 的 功能 就 是 绘制 地 图 , 再 例如 可 以 让 一 服务 提供 一 地 理 定 
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位 功能 ， 以 便 客户 能 通过 地 址 定位 地 图 。 


作为 ArcGIS 服务 器 管理 员 ， 主 要 看 


的 是 GIS 资源 以 及 服务 。 而 对 于 用 户 ， 则 更 关注 服务 器 


发 布 的 服务 所 能 提供 的 功能 。 因 此 ， 作 为 管理 员 在 将 GIS 资源 发 布 服务 时 ， 应 使 该 服务 包含 不 同 
功能 ， 作 为 服务 的 用 户 ， 则 可 以 将 这 些 功能 看 成 不 同 的 服务 。 

但 是 不 是 所 有 类 型 的 资源 都 可 以 包含 所 有 类 型 的 功能 ,一 个 资源 所 能 提供 的 功能 取决 于 该 资源 
的 类 型 。 表 3-1 列 出 了 可 包含 某 种 功能 的 资源 类 型 。 如 果 是 地 图 文档 ， 那 么 还 取决 于 里 面 的 图 层 。 
地 图 文档 可 包含 功能 最 多 ， 包 括 WMS 与 KML。 其 他 资源 ， 例 如 空间 数据 访问 与 空间 处 理 ， 需 要 


所 需 G1S 资源 

地 图 文档 Cmd 或 发 布 后 的 地 
图 文档 (pmf) 

地 图 文档 

地 图 文档 

地 图 文档 


包含 来 自 空间 数据 库 中 图 层 的 地 
图 文档 


Toolbox 文件 (.tbx) 或 包含 工具 
图 层 的 地 图 文档 


包含 网 络 分 析 图 层 的 地 图 文档 
三 维 地 图 文档 (.3dd) 


SDE 连接 文件 Csde) 、 个 人 空间 
数据 库 、 文 件 空间 数据 库 、 或 包 
含 来 自 空间 数据 库 中 图 层 的 地 图 
文档 

地 址 定位 器 文件 Cloc) 、ArcView 
3 定位 器 、ArcSDE 定位 器 、 个 人 
空间 数据 库 定位 器 、 文 件 空间 数 
据 库 定位 器 


特殊 类 型 的 图 层 。 
表 3-1 资源 类 型 与 功能 
功能 功能 描述 
地 图 绘制 提供 访问 一 地 图 文档 内 容 。 当 发 布 一 地 图 服务 时 , EA 
认 包 含 该 功能 
WMS 使 用 地 图 文档 创建 OGC 的 WMS 规范 要 求 的 服务 
移动 数据 访问 允许 从 地 图 文档 中 提取 数据 到 移动 设备 中 
KML 使 用 地 图 文档 创建 锁 孔 标记 语言 CKeyhole Markup 
Language) 要 素 
空间 数据 访问 ”允许 用 户 通 过 ArcMap 执行 复制 与 数据 提取 。 要 提供 
该 功能 , 需要 在 发 布地 图 文档 时 选择 创建 相应 的 空间 
数据 服务 
空间 处 理 提供 访问 空间 处 理 模型 ,工具 图 层 代表 从 ArcToolbox 
中 拖 动 到 地 图 文档 内 容 列 表 中 的 模型 。 当 发 布地 图 文 
档 时 ， 可 选择 创建 该 功能 。 当 发 布 空间 处 理 服 务 时 ， 
始终 包含 该 功能 
网 络 分 析 使 用 网 络 分 析 扩展 解决 网 络 分 析 问 题 
三 维 地 图 提供 访问 三 维 地 图 文档 中 的 内 容 。 当 发 布 三 维 地 图 服 
务 时 ， 始 终 包 含 该 功能 
空间 数据 提供 空间 数据 库 数据 查询 、 提 取 与 复制 功能 。 当 发 布 
空间 数据 服务 时 ， 始 终 包含 该 功能 
地 理 编码 提供 地 址 定位 功能 。 当 发 布地 理 编码 服务 时 ， 始 终 包 
含 该 功能 
地 图 文档 发 布 方法 : 


在 ArcMap 中 发 布地 图 ， 需 要 先 勾 选 菜单 Tools-Extensions 中 的 Publisher， 载 入 该 模块 。 打 开 
Publisher 工具 栏 , 点 击 Publish Maps 按钮 , 导出 一 个 pmf 文 件 . 这 个 文件 可 以 在 ArcReader 中 打开 ， 
但 是 还 不 能 分 发 ， 因 为 它 指 向 的 是 硬 编 码 的 本 地 磁盘 中 的 路 径 。 接 下 来 点 击 另 一 个 Create Data 
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Package 按钮 ， 选 择 刚 才 的 pmf 文 件 。 接 下 来 将 弹出 对 话 框 ， 可 以 选择 存放 发 布 的 地 图 的 目录 以 及 
数据 文件 的 形式 , 还 有 扩展 选项 ( 导出 全 部 要 素 或 栅 格 还 是 只 导出 当前 视图 的 部 分 ) 。 完 成 后 的 目 
录 中 出 现 了 data 和 pmf 两 个 子 目 录 ， 前 者 是 编码 后 的 数据 ， 后 者 即 发 布 的 地 图 。 


同样 的 操作 可 以 在 ArcCatalog*'P ZR, 4]: Publisher 扩展 后 ， 可 以 右键 点 击 pmf 文件， 选择 
Create Data Package。 


KML 


KML 全 称 是 Keyhole Markup Language， 是 一 个 基于 XML 语法 和 文件 格式 的 文件 ， 用 来 描述 
和 保存 地 理 信 息 如 点 、 线 、 图 片 、 折 线 并 在 Google Earth 客户 端 之 中 显示 。 


322 ”发 布 与 管理 服务 


使 用 Manager 或 ArcCatalog 都 可 以 发 布 与 管理 服务 。 
1. 使 用 Manager 发 布 与 管理 服务 


以 发 布 与 管理 地 图 服务 为 例 来 说 明 。 

按照 3.1.1. 节 中 介绍 的 方法 ， 使 用 agsadmin 组 中 的 账户 登录 到 Manager。 切 换 到 Services 选项 
卡 中 ， 点 击 Publish a GIS Resource 链接 ， 进 入 发 布 GIS 资源 向 导 的 第 一 个 页 面 ， 如 图 3.5 所 示 。 在 
该 页 面 中 ， 首 先 需 要 在 Resource 中 输入 资源 的 文件 名 (包含 绝对 路 径 ) ， 例 如 安装 程序 自身 带 的 
北美 地 图 文档 NorthAmerica.mxd, 默认 在 C:\Program Files ArcGIS DeveloperKit'SamplesNET Server 
Mata WNorthAmericamxd 目录 中 。 为 该 地 图 服务 输入 一 个 名 称 ， 例 如 NorthAmericaMap. 


EEC XL [e 


会- 日- &-3-0-0-2«€ 


Choose the folders to publish to. 


Publish 
to: Existing folder | LIUGUANG (root) v. 


O New folder: 


图 3.5 发 布 GIS 资源 向 导 一 一 指定 资源 与 服务 名 称 
输入 资源 与 名 称 参数 后 ， 选 择 Next 按钮 进入 下 一 个 页 面 ， 在 该 页 面 中 ， 需 要 设置 服务 可 提供 
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的 功能 。 如 果 发 布 的 是 一 个 地 图 文档 资源 , 那么 地 图 功能 为 默认 选项 , 此 外 还 可 选择 WMS, Mobile 
Data Access 与 KML。 如 果 地 图 文档 资源 中 的 数据 来 自 数据 库 ， 那 么 还 可 选择 Geodata Access. dX 
们 这 里 使 用 默认 值 ， 直 接 选 择 Next 按钮 进入 最 后 一 个 页 面 。 该 页 面 进行 了 总 结 ， 告 知 用 户 将 创建 
NorthAmericaMap.MapServer GIS 服务 ， 同 时 将 创建 一 个 Web 服务 ， 地 址 为 http://liuguang/arcgis 
/services/NorthAmericaMap/MapServer。 选 择 Finish 按钮 完成 发 布 服务 ， 并 返回 到 Services 页 面 。 

这 时 NorthAmericaMap 服务 将 列 在 Services 页 面 中 的 服务 列表 中 , 单 击 该 服务 左边 的 加 号 按钮 ， 
如 果 能 正确 显示 图 形 ， 如 图 3.6 所 示 ， 表 明 服 务 发 布 成 功 。 


GG- (e: T ——— HE ETE: [ra 
LEACTCE R-B 49-50-89: 2€ 


» 


Services in LIUGUANG (root) 


&f publish a GIS Resource | dadd New Service 
®© start | © stop | © Pause | @ Delete. 
Instances 
Name Type Status Eee 
e O 国 sasenap Map Service Started o 


日 日 国 wonhamericaap Map Service Started [7 


Description: 
pr $  Files\ArcGIS\DeveloperKit\SamplesNET\Server\data\NorthAmerica\mxe 
server » Capabilities: 


Pooling: Pooled 
Tutorial: Publishing a map service à 


< 


图 3.6 正确 发 布地 图 服务 后 可 显示 地 图 


利用 Services 页 面 上 的 Start, Stop. Pause 及 Delete 按钮 ， 可 启动 、 人 停止、 暂停 与 删除 选中 的 
服务 。 

要 设置 某 个 服务 的 参数 ， 例 如 需要 增加 某 些 功能 ， 可 在 Services 页 面 中 选择 该 服务 的 Edit 按 
钮 ， 进 入 服务 编辑 页 面 。 通 过 服务 编辑 页 面 左边 的 General、Parameters、Capabilities、Pooling 等 ， 
可 设置 服务 的 启动 类 型 、 图 片 输出 方式 、 功 能 以 及 实例 个 数 等 。 


2. 使 用 ArcCatalog 发 布 与 管理 服务 


要 使 用 ArcCatalog 发 布 与 管理 服务 ， 需 要 以 管理 员 方式 连接 服务 器 。 然 后 选择 右键 菜单 的 Add 
GIS Service 命令 ， 进 入 增加 GIS 服务 向 导 。 在 第 一 个 页 面 中 输入 要 发 布 的 服务 的 名 称 ， 例 如 
NorthAmericaMap。 然 后 进入 下 一 个 页 面 ， 在 这 里 输入 地 图 文档 的 文件 名 (包含 绝对 路 径 )。 然 后 
进入 功能 设置 页 面 ， 选 择 需要 的 功能 后 ， 进 入 是 否 池 化 界面 。 一 般 选 择 池 化 ， 然 后 根据 需要 设置 服 
务实 例 的 个 数 。 其 他 页 面 中 的 值 一般 使 用 默认 值 即 可 。 

在 ArcCatalog 中 发 布 服务 的 另 一 个 途径 是 ， 通 过 目录 树 找 到 某 资源 文件 ， 然 后 选择 右键 菜单 
的 Publishi to ArcGIS Server 命令 ， 即 可 发 布 服务 。 操 作 过 程 与 使 用 Manager 发 布 服务 类 似 ， 这 里 
PAHOR. 

服务 的 管理 可 以 使 用 右键 菜单 的 Service Properties 命令 打开 属性 窗口 来 完成 。 
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3.2.3 配置 地 图 缓存 


1. 为 什么 要 使 用 地 图 缓存 ? 
ArcGIS Server 在 发 布地 图 时 可 以 使 用 缓存 来 显著 提升 性 能 。 


地 图 缓存 是 一 个 包含 了 不 同比 例 尺 下 整个 地 图 范围 的 地 图 切片 的 目录 。 如 图 3.7 所 示 ， 该 地 图 
中 包含 了 两 个 比例 尺 的 图 片 缓存 , 这 样 在 服务 器 响应 客户 端的 地 图 请 求 时 ,不 需要 动态 生成 地 图 图 
片 ， 而 是 将 这 些 切 片 返回 给 客户 端 。 从 缓存 中 返回 一 个 切片 远 比 动态 生成 地 图 要 快 得 多 。ArcGIS 
的 桌面 应 用 程序 以 及 ArcGIS Server Web ADF 程序 可 以 使 用 通过 虚拟 目录 来 在 地 图 服务 中 使 用 切 
HE. 


图 3.7 地 图 切片 示意 图 


即 一 个 缓存 的 地 图 服务 就 是 能 够 利用 静态 图 片 来 快速 提供 地 图 的 服务 。 一 个 完整 的 缓存 地 图 服 
务 使 用 以 下 几 个 组 件 来 完成 其 工作 : 


口 缓存 。 这 是 由 包含 了 不 同等 级 集合 的 缓存 地 图 图 片 以 及 描述 其 缓存 的 结构 的 文件 
Cconfxml) ; 

OQ Web 服务 器 。Web 服务 器 引用 实际 的 地 图 服务 ， 一 个 虚拟 的 地 图 缓存 目录 与 真实 的 缓存 
目录 相对 应 ， 同 时 使 用 切片 处 理 服务 ， 而 其 虚拟 路 径 是 不 能 直接 访问 的 ; 

O ArcGIS 服务 器 。ArcGIS 服务 器 上 运行 着 提供 地 图 缓存 信息 的 地 图 服务 ,支持 查询 与 数据 
操作 ， 当 缓存 不 存在 或 不 可 用 时 ， 生 成 地 图 切片 。 


有 两 种 不 同类 型 的 地 图 缓存 服务 ， 分 别 是 单个 融合 缓存 与 多 图 层 缓存 。 

在 单个 融合 缓存 模式 下 , 在 每 个 比例 尺 下 所 有 图 层 融 合 在 一 块 , 创建 地 图 切片 。 这 时 融合 的 组 
存 显示 为 一 整体 图 层 ， 不 允许 单独 设置 某 个 图 层 的 可 见 性 ， 以 及 选择 要 素 与 调整 注 记 。 多 图 层 缓存 
在 某 个 比例 尺 下 为 每 个 图 层 单独 创建 地 图 切片 , 这 时 客户 端 看 到 的 是 图 层 集合 , 可 以 控制 每 个 图 层 
的 可 见 性 、 注 记 以 及 要 素 选择 。 
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是 直接 利用 缓存 路 径 中 图 片 或 使 用 切片 处 理 服 务 。 

地 图 服务 缓存 路 径 位 于 服务 器 的 缓存 路 径 中 ， 默 认为 Ci\arcgisserver\arcgiscache。 某 个 具体 的 
地 图 服务 缓存 在 该 路 径 中 创建 一 与 地 图 服务 同名 的 路 径 。 在 该 路 径 下 是 一 子路 径 , 名称 为 地 图 中 一 
数据 框架 的 名 称 。 该 路 径 中 的 内 容 因 为 创建 不 同类 型 的 缓存 而 不 同 。 如 果 创建 的 是 融合 缓存 ， 那 么 
是 一 个 名 为 _alllayers 的 子路 径 ， 如果 创建 的 是 多 图 层 缓存 ， 那 么 是 每 个 图 层 的 子路 径 。 在 每 个 图 
层 或 alllayers 的 子路 径 中 ， 是 每 个 详细 级 别 的 子路 径 ， 这 些 详细 级 别 对 应 不 同 的 比例 尺 。 在 每 个 
级 别 的 子路 径 中 是 每 切片 行 的 子路 径 , 在 该 路 径 中 存储 的 是 实际 的 图 片 文件 , 代表 该 行 中 某 具 体 列 
的 地 图 。 图 3.8 是 使 用 融合 缓存 的 地 图 服务 缓存 目录 结构 。 


te nnn G3 Levels of detail 


Tile rows 


Image files for each column 


图 3.8 ”融合 缓存 类 型 地 图 服务 缓存 目录 结构 


每 个 地 图 缓存 服务 缓存 路 径 中 都 有 一 个 名 为 confxml 的 文件 ( 见 图 3.8) ， 该 文件 完整 描述 了 
缓存 ， 包 括 其 组 织 结构 以 及 地 图 文档 的 空间 引用 与 切片 网 格 的 对 应 关系 。 切 片 网 格 使 用 详细 级 别 、 
行 与 列 来 描述 。 例 如 ， 在 LOO 详细 级 别 中 R00000000 行 的 名 为 C00000000.png 的 地 图 切片 对 应 最 
小 比例 尺 级 别 中 最 左上 角 的 切片 网 格 。 

地 图 切片 的 像素 尺寸 用 户 可 选择 ， 可 选项 包括 128. 512 或 1024 像素 ， 图 片 格式 可 为 PNG8、 
PNG24、PNG32 或 了 PEG。 图 片 根据 默认 的 透明 度 设置 背景 颜色 。 如 果 地 图 文件 中 没有 设置 背景 颜 
色 ， 那 么 默认 为 253，253，253。 该 值 可 使 用 ArcMap 来 修改 。 

使 用 缓存 地 图 服务 最 大 的 好 处 是 可 以 动态 地 改进 客户 端 用 来 显示 复杂 的 地 图 所 花费 的 时 间 。 
一 个 客户 端 使 用 缓存 地 图 服务 获取 和 显示 地 图 时 仅仅 只 是 受到 带宽 的 限制 , 由 于 动态 地 图 服务 使 用 
阴影 和 其 他 高 级 的 图 像 属 性 泻 染 和 显示 地 图 , 因此 地 图 质量 比 静 态 地 图 服务 要 好 , 但 是 所 花费 的 时 
间 也 多 ， 如 图 3.9 所 示 。 但 是 ， 如 果 使 用 了 缓存 地 图 服务 ， 由 于 地 图 切片 是 事先 生成 的 ， 而 不 需要 
动态 绘制 ， 因 此 既 可 以 保证 地 图 图 像 质量 ， 又 可 以 快速 响应 客户 端的 地 图 请 求 。 
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静态 地 图 服务 动态 地 图 服务 


ES | 


图 3.9 静态 地 图 服务 与 动态 地 图 服务 在 图 像 质量 与 效率 上 的 对 比 


缓存 地 图 服务 使 用 的 服务 器 资源 远 少 于 动态 地 图 服务 。 客 户 端 与 服务 器 初始 连接 后 , 一 旦 发 现 
有 缓存 结构 的 存在 ， 就 不 再 需要 与 服务 器 打交道 ， 而 是 直接 从 缓存 路 径 中 得 到 地 图 切片 。 


2. 创建 地 图 缓存 


ArcGIS 提供 了 多 种 方式 来 创建 一 个 缓存 地 图 服务 ，ArcCatalog、ArcToolBox、ArcToolBox、 
脚本 语言 命令 行 或 者 ArcEngine API 都 可 以 创造 缓存 地 图 服务 ， 相 对 而 言 ，ArcCatalog 提供 的 方式 

启动 ArcCatalog， 进 入 GIS 服务 器 管理 界面 ， 选 择 需 要 建立 缓存 的 服务 后 右 击 选择 Service 
Properties, 在 其 服务 属性 中 选择 Caching 选项 卡 。 在 其 中 单 击 Generate 按钮 进入 Generate Map Server 
Cache 对 话 框 ， 如 图 3.10 所 示 。 在 该 对 话 框 中 需要 对 生成 地 图 服务 缓存 进行 参数 设置 ， 主 要 设置 的 
是 参数 比例 尺 的 级 别 数 , 其 他 参数 都 保持 默认 值 即 可 。 填写 完成 后 , 单 击 OK 就 可 以 生成 地 图 缓存 。 
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图 3.10 创建 地 图 缓存 对 话 框 
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3.3 配置 文件 的 使 用 


服务 器 依据 一 组 配置 文件 来 维护 GIS 服务 器 及 其 服务 的 配置 属性 。 当 服务 对 象 管理 器 启动 时 ， 
从 这 些 配 置 文件 中 读 入 配置 信息 。 这 些 配置 文件 使 用 的 是 XML 来 定义 配置 属性 ， 包 括 服 务 对 象 容 
器 计算 机 、 输 出 路 径 的 位 置 、 服 务 配 置 属性 等 等 。 

GIS 服务 器 的 配置 文件 为 Server.dat, 该 文件 位 于 服务 对 象 管理 器 计算 机 的 ArcGIS 安装 路 径 的 
Server/System 文件 夹 中 。 服 务 配 置 文件 的 名 称 为 : 


< 服务 名 >.< 服 务 类 型 >.cfg 


它 位 于 ArcGIS 安装 路 径 的 Server/user/cfg 文件 夹 中 。 例如 名 为 Beijing 的 二 维 地 图 服务 的 配置 文件 
名 为 Beijing.MapServer.cfg。 

当 通 过 Manager 或 ArcCatalog 等 管理 界面 ， 或 通过 调用 服务 器 API 编写 的 程序 ， 来 设置 或 修 
改 服务 器 或 其 服务 的 属性 时 ， 其 实 修改 的 就 是 相应 的 配置 文件 。 

由 于 配置 文件 都 是 XML 格式 ， 因 此 可 以 通过 文本 编辑 器 手工 增加 、 删 除 以 及 修改 这 些 配 置 文 
件 。 增 加 或 删除 配置 文件 ， 以 及 修改 配置 文件 后 ， 服 务 器 不 能 立即 反应 ， 只 有 当 服 务 对 象 管理 器 重 
新 启动 时 才能 发 现 。 如 果 使 用 ArcCatalog 来 修改 ， 也 只 有 刷新 服务 器 以 后 才能 看 到 变化 。 

虽然 可 以 手工 来 增加 、 删 除 与 修改 配置 文件 ， 但 是 建议 还 是 使 用 Manager 或 ArcCatalog 等 管 
理 界 面 来 完成 .这 样 如 果 在 服务 器 配置 文件 中 有 错误 , 那么 服务 对 象 管理 器 会 在 日 志 中 记录 该 错误 ， 
并 使 用 默认 值 来 替换 不 正确 的 属性 。 如 果 存 在 一 个 错误 的 服务 配置 文件 , 那么 服务 对 象 管理 器 也 会 
记录 一 个 警告 ， 并 忽略 该 配置 文件 。 


3.3.1 服务 器 配置 文件 


Server.dat 是 服务 器 配置 文件 ， 文 件 中 保存 服务 器 的 属性 。 当 服务 对 象 管理 器 启动 时 ， 需 要 读 
入 该 文件 的 内 容 。 如 果 成 功 读 入 该 文件 ， 并 完成 了 文件 中 指定 的 每 一 个 具体 的 初始 化 ， 服 务 器 就 会 
报告 成 功 启动 。 如 果 文 件 中 有 错误 ,那么 服务 对 象 管理 器 会 在 日 志 中 记录 错误 ， 并 使 用 默认 值 来 代 
蔡 不 正确 的 属性 。 

当 服 务 器 初次 安装 服务 对 象 管理 器 时 ，Server.dat 文件 并 不 存在 。 只 有 服务 对 象 管理 器 启动 以 
后 ， 或 者 在 GIS 服务 器 加 入 服务 对 象 容器 或 服务 器 路 径 时 ，Server.dat 文件 才 会 被 创建 。 

下 面 是 笔者 GIS 服务 器 的 Server.dat 文件 内 容 。 该 内 容 表明 该 GIS 服务 器 包含 一 个 服务 对 象 容 
器 〈liuguang) ， 一 个 缓存 路 径 、 一 个 任务 路 径 与 一 个 输出 路 径 ， 日 志 级 别 为 3。 


«Server» 
XServerMachines» 

«Machine» 
XName»liuguangc/Name» 
XDescription»«/Description» 
«Capacity»-1«/Capacity» 

«/Machine» 
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«/ServerMachines» 
XServerDirectories» 
«Directory» 
XPath»c:NarcgisserverVarcgiscache«/Path» 
XURL»http://liuguang:8399/arcgis/server/arcgiscache«/URL» 
«Description»«/Description» 
XType»cache«/Type» 
</Directory> 
<Directory> 
<Path>c:\arcgisserver\arcgisjobs</Path> 
<URL>http://liuguang:8399/arcgis/server/arcgisjobs</URL> 
<Description></Description> 
<Type>jobs</Type> 
<Cleaning>sliding</Cleaning> 
<MaxFileAge>21600</MaxFileAge> 
</Directory> 
<Directory> 
<Path>c:\arcgisserver\arcgisoutput</Path> 
<URL>http://liuguang:8399/arcgis/server/arcgisoutput</URL> 
<Description></Description> 
<Type>output</Type> 
<Cleaning>sliding</Cleaning> 
<MaxFileAge>600</MaxFileAge> 
</Directory> 
</ServerDirectories> 
<Properties> 
<LogPath>C:\Program Files\ArcGIS\server\user\log\</LogPath> 
<LogLevel>3</LogLevel> 
<LogSize>10</LogSize> 
<ConfigurationStartTimeout>300</ConfigurationStartTimeout> 
<EngineContextTimeout>600</EngineContextTimeout> 
</Properties> 
</Server> 


3.82 ”服务 配置 文件 


服务 配置 属性 保存 在 GIS 服务 器 的 cfg 文件 夹 中 ， 每 一 个 配置 对 有 一 对 应 的 文件 。 当 在 GIS 
服务 器 中 增加 一 个 服务 配置 时 ， 就 自动 创建 一 新 的 配置 文件 。 当 某 一 配置 被 删除 时 ， 其 配置 文件 从 
cfg 文件 夹 中 也 被 删除 。 
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简单 Web GIS 应 用 开 e 


ArcGIS Server 提供 了 强大 的 应 用 程序 开发 框架 ， 可 满足 开发 功能 强大 的 企业 级 地 理 信 息 
系统 。 本 章 将 主要 介绍 如 何 创建 简单 的 Web GIS 应 用 程序 以 及 相关 的 基础 知识 。 
通过 本 章 你 将 了 解 到 : 


4.1 
4.2 
4.3 
4.4 
4.5 
4.6 


创建 Web GIS 应 用 的 几 种 方法 
关于 Web 应 用 程序 框架 

部 分 页 面 刷新 的 实现 一 一 Ajax 
自 定义 工具 与 命令 

属性 查询 图 形 

右键 菜单 与 地 图 图 片 保存 
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4.1 创建 Web GIS 应 用 的 几 种 方法 


ArcGIS Server 提供 了 几 种 可 选 方法 来 帮助 程序 员 开 发 Web GIS 应 用 程序 。 最 简单 的 方法 是 利 
用 Manager 工具 来 创建 ， 其 次 是 使 用 与 Visual Studio 2005 集成 的 模板 创建 ， 最 灵活 但 是 要 求 最 高 
的 是 直接 使 用 Web 控件 创建 。 


4.1.1 使 用 Manager 工具 创建 


创建 应 用 最 简单 的 方法 是 先 使 用 Manager 工具 中 的 向 导 来 创建 一 个 Web GIS 应 用 ， 然 后 在 
Visual Studio 2005 中 针对 具体 的 需要 进行 修改 。 
使 用 Manager 工具 创建 应 用 的 基本 步 又 如 下 : 


按照 本 书 中 3.1.1 节 中 介绍 的 方法 ， 使 用 agsadmin 组 中 的 账户 登录 到 Manager。 切 换 到 
Applications 选项 卡 , 然后 点 击 Create Web Application 链接 , 进入 创建 Web 应 用 向 导 的 第 一 个 页 面 。 

在 第 一 个 页 面 中 ，Host 对 话 框 里 面 已 经 填写 了 值 ， 默 认为 GIS 服务 器 的 计算 机 名 。 需 要 填写 
的 是 Name， 即 应 用 的 名 称 ， 我 们 这 里 输入 NorthAmericaGis。 然 后 选择 Next 按钮 进入 向 导 的 第 二 
个 页 面 。 

在 第 二 个 页 面 中 ， 需 要 选择 地 图 中 要 包含 的 图 层 。 如 果 是 第 一 次 使 用 该 向 导 ， 那 么 首先 需要 
点 击 Add GIS Server 链接 ， 加 入 GIS 服务 器 。 界 面 如 图 4.1 所 示 。 


Select Layers Preview Layers 


Choose the map services to di. 
Ac 


Available Services: " C N Services: 


~ 


a web application, 
je current 
GIS 


图 4.1 增加 GIS 服务 器 向 导 
在 该 向 导 中 ， 首 先 选择 连接 方式 ， 我 们 这 里 选择 ArcGIS Server Local， 然 后 在 Host 中 输入 要 


ZAN 
(s) b Web GIS 开发 一 一 ArcGIS Server 与 .NET 


连接 的 GIS 服务 器 的 计算 机 名 或 他 地址。 选择 Add Server 按钮 ， 将 该 GIS 服务 器 添加 到 可 访问 的 
服务 列表 框 中 。 展 开 该 GIS 服务 器 以 后 ， 可 看 到 该 服务 器 所 发 布 的 服务 。 如 果 读 者 完成 了 本 书 中 
的 3.2.2 节 中 示例 ， 那 么 就 会 看 到 名 为 NorthAmericaMap 的 服务 。 选 择 该 服务 ,使 用 Add 按钮 将 该 
服务 加 入 到 选择 的 服务 列表 框 中 。 在 该 页 面 中 ， 还 可 切换 到 Preview Layers 选项 卡 中 ， 查 看 地 图 效 
果 。 完 成 选择 服务 后 ， 选 择 Next 按钮 进入 向 导 的 第 三 个 页 面 。 

在 第 三 个 页 面 中 ， 需 要 选择 任务 。 为 了 简单 起 见 ， 先 不 选择 任何 任务 ， 直 接 选 择 Next 按钮 进 
入 向 导 的 第 四 个 页 面 。 

在 第 四 个 页 面 中 ， 需 要 设置 连接 服务 器 的 用 户 。 默 认 已 经 选择 为 登录 Manager 工具 的 用 户 ， 
一 般 可 满足 需要 。 因 此 可 直接 选择 Next 按钮 进入 向 导 的 第 五 个 页 面 。 

在 第 五 个 页 面 中 ， 需 要 设置 Web 应 用 程序 的 主页 面 的 属性 ， 包 括 应 用 程序 标题 、 主 色调 以 及 
页 面 上 的 链接 。 我 们 这 里 将 标题 设置 为 “北美 洲 地 图 演示 系统 ”， 然 后 选择 Next 按钮 进入 向 导 的 
第 六 个 页 面 。 

在 第 六 个 页 面 中 ， 需 要 设置 应 用 程序 包含 的 一 些 地 图 要 素 ， 包 括 图 层 控制 、 鹰 眼 、 工 具 栏 、 
指 北 针 与 比例 尺 。 默 认 都 包含 ， 因 此 可 直接 选择 Next 按钮 进入 向 导 的 最 后 一 个 页 面 。 

在 向 导 的 最 后 一 个 页 面 中 ， 总 结 了 应 用 程序 的 一 些 基本 信息 。 确 保 选择 了 “在 新 窗口 中 显示 
应 用 程序 ”。 然 后 选择 Finish 按钮 ， 将 在 一 新 的 浏览 器 窗口 中 显示 该 Web 应 用 程序 的 运行 结果 。 


由 于 我 们 这 里 使 用 的 是 局 域 网 连接 ， 因 此 应 用 程序 会 由 于 没有 身份 验证 信息 ， 而 不 能 正确 显 
示 地 图 ， 需 要 利用 Visual Studio 2005 对 源 代码 进行 编辑 。 
启动 Visual Studio 2005 ,在 开始 页 面 中 选择 打开 Web 站 点 ,然后 在 对 话 框 的 左边 选择 Local IIS, 
从 右边 站 点 列表 中 选择 NorthAmericaGis (该 站 点 源 代码 位 于 IIS 的 NorthAmericaGis 路 径 中 ， 默 
认为 cinetpubwwwrootNorthAmericaGis) 。 
打开 站 点 后 , 在 解决 方案 窗口 中 右 击 该 站 点 名 称 ， 然 后 选择 Add ArcGIS Identity 命令 , 将 打开 
如 图 4.2 所 示 的 对 话 框 。 在 该 对 话 框 中 输入 用 户 名 、 口 令 以 及 GIS 服务 器 的 计算 机 名 。 


Add ArcGIS Identity 


ArcGIS Identity 


Type the user name, password, and domain for an account that 
this web application should impersonate. 


User Nane: [Administrator 


Password: eeen] 


Domain or [Bec 0830-1 
Machine Name: = 


[V] Encrypt identity in web. config 


图 4.2 “添加 ArcGIS 身份 ”对 话 框 
添加 完成 以 后 ， 运 行程 序 ， 便 可 得 到 正确 的 结果 ， 如 图 4.3 Hr. 
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S [V]NorthAmericaMap. 
S [V]cam bnd 
困 [v]canada 


S [v] mexico 
S [v]States 


图 4.3 通过 Manager 工具 创建 Web 应 用 的 结果 
4.1.2 使 用 Visual Studio 模板 创建 


ArcGIS Server 安装 时 ， 会 在 Visual Studio 2005 中 安装 一 Web 应 用 模板 。 该 模板 就 是 Manager 
工具 创建 Web 应 用 的 模板 。 

启动 Visual Studio 2005 后 ， 在 开始 页 面 中 选择 创建 Web 站 点 , 打开 New Web Site 对 话 框 (图 
44) ， 在 该 对 话 框 的 模板 中 选择 “Web Mapping Application”。 站 点 位 置 选择 为 HITP， 站 点 名 称 
为 NorthAmericaSample， 语 言 为 Visual C£. 


Templates: 
. Visual Studio installed templates 


RASP. NET Web Site ASP.NET w ce 请 Persond Feb Site Starter Kit 
y Enpty Web Site qm 


My Templates 


ClSearch Online Tenplates. 


Template for Web Mapping Application 


Location: [mre (| [http://Localhost/Nor thAneri caSanple 


Language: [visual ce x~] 


图 4.4 使 用 模板 创建 Web 应 用 
选择 OK 后 ， 将 创建 包含 图 4.5 所 示 内 容 的 站 点 ， 与 利用 Manager 工具 创建 的 Web 应 用 程序 
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所 包含 的 内 容 是 一 致 的 。 


Solution Explorer - http://localhost/NH...[X) 

da £, Ra i 
Edhttp://localhost/NorthAmericaSample/ 

LE App. Code 

LI App. Data 

[3f App. Themes 

Help 

images 

D JavaScript 

司 ApplicationClosed. aspx 

Es] Default. aspx 

£3] ErrorPage. aspx 

P Global. asax 

Measure. ascx 

B Reade. txt 

E3 Web. Config 

划 Web. sitemap 

E) WebMapAppCSharp. ico 


图 


由 
由 
由 
由 
由 
由 
由 


E] 


GuSolution Ex... [fa Server Expl... [ggClass View 


图 4.5 利用 模板 创建 的 Web 应 用 程序 所 包含 的 内 容 


DefaulLaspx 页 面 是 主页 面 ， 包 含 了 地 图 及 其 相关 联 的 控件 与 内 容 ; 

ErrorPage.aspx 是 错误 页 面 ， 当 应 用 程序 遇 到 未 处 理 的 错误 时 显示 该 页 面 ; 
ApplicationClosed.aspx 页 面 是 当 用 户 单 击 关闭 链接 (只 有 使 用 非 池 化 ArcGIS 服务 器 数据 
源 时 才 会 显示 ) 时 显示 的 页 面 。 这 样 可 允许 程序 释放 在 GIS 服务 器 上 使 用 的 资源 ; 
Measure.ascx 是 一 自 定义 用 户 控件 ， 该 控件 在 Default.aspx 中 使 用 ， 用 于 在 地 图 上 测量 距 
离 与 面积 ; 

Web.config 是 一 标准 的 ASP.NET 配置 文件 ， 里 面 存储 了 .NET 配置 信息 ， 以 及 当 使 用 
ArcGIS Server Local 数据 源 时 的 身份 信息 ; 

Web.sitemap 是 ASP.NET 2.0 站 点 地 图 配置 文件 。Default.aspx 中 的 SiteMapDataSource 控 
件 使 用 该 文件 在 Menu 控件 中 显示 其 中 的 链接 ; 

ReadMe txt 中 包含 了 在 Visual Studio 中 配置 web 应 用 程序 的 简单 描述 ; 

App Code 是 一 标准 的 ASP.NET 文件 夹 ,用 于 存放 代码 , 其 中 包含 了 Mapldentify.cs 文件 ， 
该 文件 用 于 点 查询 工具 .App_Data 和 App-Themes 也 是 标准 的 ASP.NET 文 件 夹 .App-Data 
用 于 存放 应 用 程序 的 数据 ， 通 常 是 SQL Server Express 数据 库 。App_Themes 用 于 存放 不 
同 主题 的 文件 , 包括 样式 表单 、 皮 肤 文件 以 及 图 片 . Help 文件 夹 中 包含 了 帮助 文件 . images 
文件 夹 包 含 了 程序 使 用 的 图 片 。JavaScript 文件 夹 包 含 了 程序 使 用 的 JavaScript 库 文件 。 


该 Web 应 用 还 需要 使 用 存放 在 IS 根 路 径 中 aspnet_client 文件 夹 中 的 ASP.NET 公用 文件 ， 这 
些 文件 通常 在 CA\Inetpub\vwwwrootvaspnet cjlientESRTWebADF 中 。 该 文件 夹 中 包含 了 ESRI 的 Web 


控件 使 


的 图 片 、JavaScript 库 以 及 样式 表单 。Web 应 用 程序 必须 要 能 访问 这 些 文件 才能 正常 工作 。 
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Defaultaspx 是 Web 应 用 中 主要 显示 地 图 的 页 面 。 该 页 面包 含 了 显示 地 图 的 Web 控件 以 及 相 
关 的 辅助 控件 ， 例 如 图 层 控制 、 鹰 眼 以 及 与 地 图 交互 的 工具 。 默 认 包含 的 控件 及 其 设置 如 图 4.6 所 
示 。 


ope ener - Hoole cre! 
—ÁY 
Warning: Ton want antar a valid value far the ResewceItens property. 


e mainas 


eor LL] 


图 4.6 Defaultaspx 页 面 中 的 内 容 


Defaultaspx 页 面 中 也 包含 有 与 服务 器 通讯 的 代码 ， 例 如 获取 地 图 图 像 切 片 。 通 过 回调 

(Callback) 技术 ， 该 页 面 通常 不 用 刷新 整个 页 面 。 页 面 将 消息 发 送 给 服务 器 ， 然 后 只 刷新 相关 部 

分 来 显示 返回 结果 。 例 如 ， 当 用 户 使 用 点 查询 工具 在 地 图 上 单 击 后 ， 页 面 使 用 回调 ， 从 服务 器 得 到 
返回 结果 ， 并 将 结果 显示 在 任务 结果 面板 中 ， 而 不 是 使 用 回 发 CPostback) 导致 整个 页 面 刷新 。 

当 使 用 模板 创建 Web 应 用 后 ,第 一 个 要 设置 的 就 是 MapResourceManager 控件 的 ResourceItems 
属性 。 从 MapResourceManager 控件 的 名 称 就 可 以 看 出 该 控件 是 用 于 管理 地 图 资源 的 ， 页 面 中 地 图 
控件 的 显示 内 容 由 该 控件 管理 。 

首先 切换 到 Default.aspx 页 面 的 设计 视图 ， 选 择 MapResourceManager 控件 ， 然 后 在 属性 页 面 
中 单 击 ResourceItems 右 侧 的 省 略 号 ， 打 开 地 图 资源 项 集合 编辑 器 ， 如 图 4.7 所 示 。 

在 地 图 资源 项 集合 编辑 器 中 ， 默 认 时 其 内 容 为 空 。 选 择 Add 按钮 增加 一 MapResourceItem 对 
象 。 该 对 象 中 包含 了 几 个 属性 ， 这 些 属性 用 于 控制 该 地 图 资源 的 数据 源 如 何 被 应 用 程序 中 的 地 图 、 
图 层 控 制 等 其 他 控件 应 用 。 

其 中 Name 属性 用 于 在 应 用 程序 中 唯一 标识 该 资源 。 该 名 称 作 为 地 图 服务 显示 在 图 层 控制 控件 
中 。 默 认 名 称 一 般 是 MapResourceItem 加 序号 ， 一 般 建 议 修改 为 地 图 服务 的 名 称 。 我 们 这 里 设置 为 
NorthAmericaMap. 
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Map Resource display settings. 


a 


图 4.7 地 图 资源 项 集合 编辑 器 


单 击 Appearance 属性 组 下 DisplaySettings 右 侧 的 省 略 号 ， 可 打开 “地 图 资源 显示 设置 编辑 器 ” 
(图 4.8) 。 该 编辑 器 用 于 定义 地 图 资源 生成 图 片 的 内 容 。 

透明 颜色 与 背景 共同 决定 了 地 图 图 片 的 透明 绘制 ,融合 属性 定义 该 地 图 图 片 相对 于 其 他 资源 的 
地 图 图 片 的 可 见 性 。 当 地 图 中 同时 显示 几 个 地 图 资源 中 的 地 图 时 , 每 个 地 图 资源 所 生成 的 图 片 需要 
融合 为 一 张 图 片 。 在 资源 列表 中 最 下 面 的 地 图 资源 最 先 绘制 , 然后 是 上 面 的 地 图 资源 绘制 。 透明 值 
CTransparecy). 用 于 定义 该 地 图 资源 所 生成 的 图 片 的 透明 程度 。0% 表 示 图 片 不 透明 ，100% 表 示 完 
全 透明 ， 也 就 是 不 可 见 ， 界 于 这 两 者 之 间 的 值 表示 可 显示 位 于 该 地 图 下 面 的 其 他 地 图 资源 的 内 容 。 
当 图 片 部 分 透明 时 ， 融 合 所 有 地 图 资源 的 图 片 就 会 花费 更 长 的 时 间 。 需 要 MIME 数据 (Recuest 
MIME Data) 选项 确定 如 何 从 数据 源 请 求 地 图 图 片 。 如 果 数 据 源 支 持 以 MIME 格式 发 送 地 图 图 片 ， 
那么 该 图 片 就 会 被 应 用 程序 保存 在 内 存 中 。 如 果 不 支持 或 没有 选择 MME 数据 ， 那 么 数据 源 必须 
先 在 服务 器 的 输出 路 径 中 生成 一 图 片 文件 ， 然 后 与 应 用 程序 共享 该 文件 所 在 文件 夹 。 图 片 格式 
(Image Format). 确定 了 数据 源 生成 的 图 片 的 格式 。 可 见 选项 (Visible) 确定 是 否 生成 地 图 图 片 。 
在 图 层 控制 中 显示 选项 (Display)〉 人 允许 隐藏 资源 。 该 资源 在 地 图 或 应 眼 控件 中 仍 可 显示 ， 也 还 可 
被 SearchAttributesTask 等 其 他 控件 利用 。 


Map Resource Display Settings Editor 
Set transparency and blending settings. 


Request MINE Data Inage Format | PNG8 EZ 
M visible [V] Display in the Table of Contents 


E Emm 


图 4.8 地 图 资源 显示 设置 编辑 器 
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在 地 图 资源 项 集合 编辑 器 中 ，Definition 属性 提供 了 一 系列 对 话 框 来 连接 数据 源 提供 者 〈 例 如 
GIS 服务 器 ) 与 创建 地 图 资源 。 单 击 Definition 右 劳 的 省 略 号 ， 打 开 资 源 定义 编辑 器 。 在 该 编辑 器 
中 ， 首 先 要 确定 数据 源 的 类 型 ， 不 同类 型 需要 不 同 的 设置 。 

最 常用 的 是 ArcGIS Server Local 类 型 , 这 也 是 我 们 这 里 要 详细 说 明 与 使 用 的 类 型 。 选 择 好 类 型 
后 ,需要 设置 数据 源 。 如 果 程序 员 开发 使 用 的 计算 机 就 是 GIS 服务 器 ， 那么 可 设置 为 localhost; 如 
果 要 设置 为 GIS 服务 器 的 是 局 域 网 内 其 他 计算 机 ， 设 置 为 计算 机 名 或 他 地 址 均 可 。 一 旦 设置 好 数 
据 源 以 后 ，Resource 属性 打开 ArcGIS 资源 定义 编辑 器 ， 通 过 该 编辑 器 可 选择 服务 器 中 的 某 个 地 图 
服务 。 这 里 我 们 选择 第 3 章 创 建 的 NorthAmericaMap 地 图 服务 。 设 置 过 程 如 图 4.9 所 示 。 


Map Resource Definition Editor 
Choose a type from the list. Click to enter details for data source, 
identity and resource. 


ArcGIS Data Source Definition Editor 
Type the name of your server. 


ArcGIS Resource Definition Editor 
Select a service and a data frame. 


Service. Nor thAneri callap 


Data Frane: 


[3:10] 
E Em 


图 4.9 设置 ArcGIS 数据 源 作 为 地 图 资源 


这 时 便 可 编译 并 运行 程序 ， 运 行 结果 与 图 4.3 一 致 。 

在 地 图 资源 定义 编辑 器 中 Identity (身份 ) 属性 为 灰色 ， 表 示 不 可 设置 。 在 设计 阶段 使 用 运行 
Visual Studio 用 户 的 身份 去 连接 ArcGIS 服务 器 的 本 地 数据 源 ， 在 运行 期 间 ，Web 应 用 程序 会 自动 
建立 该 身份 。 在 一 个 Web 应 用 程序 中 只 能 使 用 一 个 身份 来 访问 ArcGIS 服务 器 本 地 数据 源 。 添 加 
ArcGIS 身份 的 方法 可 按照 4.1.1 节 中 的 介绍 。 


4.1.3 使 用 Web 控件 创建 


有 时 如 果 系 统 比 较 简单 (为 了 便于 读者 理解 ， 本 书 的 大 部 分 实例 使 用 该 方式 ,因此 读者 需要 很 
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好 的 理解 该 节 介绍 的 步 又， 后 面 将 不 再 歼 述 ， 而 只 直接 引用 ) ， 我 们 可 以 直接 使 用 ArcGIS Server 
的 Web ADF 所 提供 的 控件 ， 而 不 是 使 用 模板 ， 来 创建 Web 应 用 程序 。 这 是 因为 模板 包含 了 许多 
系统 不 需要 代码 与 资源 。 

Web ADF 控件 集成 在 Visual Studio 2005 的 可 视 化 设计 环境 中 ， 可 以 像 使 用 Visual Studio 2005 
提供 的 控件 〈 例 如 文本 框 、 按 钮 ) 一 样 来 使 用 这 些 控件 。 

下 面 的 例子 演示 了 如 何 使 用 Web ADF 控件 从 零 开 始 创建 一 个 Web 应 用 程序 。 步 又 如 下 : 


(1) f£ Visual Studio 2005 中 ， 选 择 File 菜单 中 的 New Web Site 命令 ， 将 弹出 New Web Site 

(2) 在 New Web Site 对 话 框 中 , 将 Location 的 值 设 置 为 HITP, 将 Language 设置 为 Visual C#。 

(3) 在 Visual Studio installed templates 中 ， 选 择 ASPNET Web Site。 

(4) 输入 该 Web 应 用 的 名 称 与 位 置 ， 这 里 设置 为 http://localhost/FromControl。 然 后 选择 OK. 
这 时 Visual Studio 2005 将 在 设计 视图 中 显示 一 个 空白 的 Default.aspx 页 面 。 

C5) 打开 Visual Studio 的 工具 箱 ， 并 展开 ArcGIS Web Controls 选项 卡 。 分 别 拖 动 一 个 地 图 资 
源 管理 控件 (MapResourceManager) 与 一 个 地 图 控件 (Map) 到 Defaultaspx 页 面 中 ， 保 留 它们 默 
认 的 ID 设置 ， 即 分 别 为 MapResourceManagerl 与 Mapl. 

(6) 下 面 需要 设置 的 是 MapResourceManager 控件 的 ResourceItems 属性 。 过 程 及 设置 同 4.1.2 
节 中 有 关 地 图 资源 管理 控件 设置 内 容 的 介绍 。 

CD 将 地 图 控件 Mapl 的 MapResourceManager 属性 值 设置 为 MapResourceManager] 。 

(8) 调整 地 图 控件 Mapl 的 大 小 ， 例 如 300X300、500X500 等 像素 。 

(9) 在 Default.aspx 页 面 中 加 入 一 个 内 容 目 录 控 件 (Toc，Table of Contents 的 缩写 ) ， 保 留 
其 ID 的 默认 设置 ， 即 为 Tocl。 

C100 将 控件 的 定位 改变 为 绝对 值 定位 ， 这 样 才能 使 控件 可 放置 到 页 面 中 的 任何 位 置 。 右 击 
Tocl 控件 , 选择 右键 菜单 中 的 Style 命令 , 打开 Style Builder 对 话 框 。 在 该 对 话 框 中 切换 到 Position 
选项 卡 ， 然 后 将 Position mode 设置 为 Absolutely position， 如 图 4.10 所 示 。 选 择 OK 按钮 退出 对 话 
框 。 现 在 可 在 设计 视图 中 将 Tocl 拖 动 到 地 图 控件 的 右边 。 


SIS gam 


T 


图 4.10 设置 定位 方式 


(11) 将 Tocl 控件 的 BuddyControl 属性 设置 为 Map1， 这 样 就 可 以 用 Tocl 控件 来 控制 Map1 


中 显示 的 图 层 。 
(12) 在 Default.aspx 页 面 中 加 入 一 个 工具 条 控件 Toolbar) ， 保 留 其 默认 的 ID 设置 ， 即 为 
Toolbarl. 


(13) 设置 Toolbarl 控件 的 BuddyControls 属性 。 该 属性 是 一 连接 控件 集合 , 在 集合 中 加 入 Map1。 
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(14) 设置 Toolbarl 控件 的 Toolbarltems 属性 。 通 过 属性 视图 打开 如 图 4.11 所 示 的 
ToolbarCollectionEditorForm 对 话 框 。 在 该 对 话 框 , 添加 Web ADF 已 经 封装 好 的 地 图 操作 按钮 ， 包 
括 放大 CMapZoomIn) 、 缩 小 (MapZoomOut) 、 漫 游 (MapPan) 以 及 MapFullExtent (全 图 〉。 
加 入 工具 按钮 后 ， 选 择 OK 按钮 退出 对 话 框 。 


Current Toolbar Contents: 
G MepZooeIn 
局 mapzeoe0at 
rn 
© MopFallExtent 


E TE 
@ Magocnln 
pm 
E 
© MapFallistent 


Fd] 4.11 通过 ToolbarCollectionEditorForm 对 话 框 加 入 工具 按钮 


(15) 按照 4.1.1 节 中 介绍 的 方法 增加 ArcGIS 身份 。 


至 此 我 们 就 通过 直接 使 用 Web ADF 提供 的 控件 , 创建 了 一 个 简单 的 Web GIS 应 用 程序 。 运行 
应 用 程序 ， 可 得 到 如 图 4.12 所 示 的 界面 。 


Untitled Pare - Nicrosoft Internet Explorer DER 
XED MIO HEV KEW IAD 帮助 0 
O=- 0 NAG smX"-eocs2-5U88« 


(Æ http: //1occthost/FrenContrsl/Defeil t. aspx 


= [e;MapResourceltemo 
a Beam bad 
n 
~ 日 回 cannda 
T s 


日 加 mexico 
n 


日 回 States 
口 


& & d e 
Zoom In Zoom Out Pan Full Extent 


图 4.12 系统 运行 界面 
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4.2 关于 Web GIS 应 用 程序 框架 


Web 应 用 程序 框架 (Web ADF) 是 ESRI 为 了 简化 在 Web 上 提供 如 地 图 浏览 这 样 的 GIS 服务 
而 实现 的 一 个 开发 框架 。 


4.2.1 Web 应 用 程序 框架 体系 结构 


Web ADF 与 其 他 的 相关 组 件 的 关系 如 图 4.13 所 示 。 


Web Application Developer Framework (ADF) 
for the Microsoft .NET Framework 
ArcGIS 


ArcGIS Server. 


Server 


Web Service ArcIMS 


ArcObjects 


图 4.13 Web ADF 与 其 他 相关 组 件 的 关系 


s 
E 
n 
u 


从 图 中 可 看 到 ，Web ADF 是 建立 在 Microsoft .NET 框架 之 上 的 一 些 新 的 类 ， 这 些 新 的 类 扩展 
了 .NET 框架 类 库 ， 提 供 了 一 系列 自 定义 Web 控件 以 及 支持 本 地 与 远程 访问 的 数据 源 。 图 的 右 部 也 
清楚 地 表明 了 Web ADF 在 整个 ESRI 类 库 中 的 位 置 。 

以 前 版 本 的 ADF 称 为 ArcGIS Server ADF， 那 是 因为 它 只 支持 单一 的 数据 源 ， 即 基于 
ArcGISObjects 的 ArcGIS Server。 而 现在 的 Web ADF 在 两 个 方面 进行 了 扩展 。 一 个 是 当前 的 ADF 
支持 多 个 数据 源 ， 包 括 ArcGIS Server 与 ArcIMS 等 。 另 一 个 是 该 多 数据 源 架构 允许 在 同一 应 用 程 
序 中 同时 集成 与 访问 来 自 不 同 来 源 的 数据 。 

一 个 单独 的 数据 源 可 以 提供 几 个 功能 。 例 如， 一 个 ArcIMS 地 图 服务 可 用 于 输出 地 图 图 片 ， 还 
可 以 用 于 查询 要 素 图 层 与 地 理 编码 。 Web ADF 中 的 Web 控件 是 一 些 显示 与 访问 地 理 数据 的 可 视 化 
控件 。 这 些 控件 如 何 使 用 数据 源 依 赖 于 数据 源 能 做 什么 。 


1. Web 控件 、 资 源 管理 器 、 资 源 与 功能 与 之 间 的 关系 


那么 Web 控件 是 如 何 与 数据 源 连接 的 呢 ? 答案 如 图 4.14 所 示 。 控 件 和 数据 源 之 间 的 关系 是 通 
过 一 系列 的 资源 管理 器 CResouce Manager) 控件 来 维护 的 。 资 源 管 理 器 决定 哪些 数据 源 是 可 以 使 
用 的 资源 (Resouces) ， 以 及 这 些 资源 怎么 被 控件 所 使 用 。 一 旦 一 个 数据 源 被 资源 管理 器 管理 之 后 ， 
就 被 展现 为 资源 。 控件 通过 资源 到 达 数 据 源 。 资 源 可 以 把 数据 源 以 多 种 形式 展现 出 来 ， 比 如 可 以 提 
供 一 幅 地 图 展现 在 地 图 控件 中 , 它 也 可 以 把 数据 源 以 图 层 列表 的 方式 展现 在 内 容 目录 控件 中 , 也 就 
是 说 资源 拥有 不 同 的 能 力 ， 这 些 不 同 的 能 力 我 们 称 为 不 同 的 “功能 ” (Functionality) 。 功 能 定义 
了 资源 怎么 被 使 用 。 
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Web Controls 


Resource Managers 


Resources Functionalities 


Data Sources 


Data Source 
Specific APIs 


图 4.14 ”Web 控件 与 资源 管理 器 、 资 源 、 功 能 、 数 据 源 之 间 的 关系 


Q ”从 控件 角度 来 讲 ， 不 同 的 控件 可 以 通过 不 同 的 方式 来 使 用 相同 的 数据 源 ， 比 如 一 个 资源 
可 以 为 地 图 控件 提供 一 幅 地 图 ， 也 可 以 为 内 容 目 录 控 件 提供 一 套图 层 的 列表 ， 这 就 是 资 
源 的 不 同 的 功能 ; 

O ”从 数据 源 角度 来 讲 ， 不 同 的 资源 会 通用 的 展现 一 些 能 力 ， 也 就 是 提供 不 同 的 功能 ， 比 如 
展现 地 图 ， 查 询 地 图 等 。 


2. 公有 API 与 特有 API 的 关系 


资源 可 以 展现 为 不 同 的 能 力 ,但 是 具体 能 够 展现 为 哪些 能 力 还 是 要 看 数据 源 本 身 能 够 提供 什么 
样 的 功能 。 有 一 些 功能 是 所 有 数据 源 都 能 办 到 的 , 也 就 是 说 资源 可 以 展现 出 一 些 所 有 的 数据 源 都 可 
以 提供 的 能 力 ， 比 如 提供 地 图 ， 比 如 查询 地 图 ， 无 论 是 ArcGIS Server 作为 数据 源 ， 还 是 ArcIMS 
作为 数据 源 ， 这 些 都 是 基本 的 能 力 。 因 此 Web ADF 就 把 实现 这 些 基本 的 普通 的 功能 所 需要 的 类 归 
为 公有 API (Common API) 。 而 有 些 功 能 是 有 些 数据 源 特 有 的 ， 比 如 提供 编辑 功能 ， 那 是 ArcGIS 
Server AHJ, ArcIMS 无 法 提供 。 这 些 就 被 称 为 特有 API (Specific API) 。 特 有 API 包括 ArcIMS 
API, ArcWeb API, OGC\WMS API, ArcGIS Server SOAP API 与 ArcGIS Server ArcObject API (图 
4.15) 。 注 意 其 中 的 ArcObject API 也 被 列 为 了 特有 API， 它 是 ArcGIS Server 数据 源 的 特有 API. 


图 4.15 ”使 用 不 同 的 API 访问 不 同 数据 源 
3. 公有 API 的 基本 结构 
Web ADF 的 多 源 架构 的 基础 是 公有 API， 它 是 一 包含 类 与 接口 的 抽象 框架 。 不 同 的 数据 源 可 
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通过 实现 公有 API 来 作为 插入 到 Web ADF 中 。 
我 们 在 开发 过 程 中 首先 接触 到 的 也 就 是 这 些 公有 APIs， 主 要 包含 三 个 接口 : 


Q IGISDataSouce， 定 义 了 数据 源 的 连接 。 
口 IGISResouce， 定 义 了 数据 源 提供 的 信息 类 型 等 。 
口 、IGISFunctionality， 定 义 了 资源 怎么 被 使 用 。 


这 三 个 接口 是 不 同 的 数据 源 可 以 展现 一 些 基本 功能 的 基本 接口 , 也 就 是 说 不 同 的 数据 源 要 实现 
基本 的 功能 必须 实现 这 三 个 基本 的 类 , 才能 在 控件 上 展现 出 那些 基本 的 能 力 。 各 种 数据 源 都 用 相应 
的 类 实现 了 这 三 个 接口 。 这 三 个 接口 之 间 的 关系 如 图 4.16 所 示 。 


1IGISFunctionality 


IGISFunctionality 


IGISDataSource 


IGISResource IGISFunctionality 


IGISFunctionality 
图 4.16 公有 AP 中 主要 三 个 接口 的 关系 


一 个 数据 源 (GISData Source) 会 包含 一 系列 的 资源 (GISResource) o LA ArcGIS Server Local 

言 ， 它 包含 了 MapResouce、GeocodeResouce、GeoprocessingResouce 等 几 种 资源 。 一 个 资源 又 会 

包含 一 系列 的 功能 CGISFunctionality) 。 功 能 主要 有 两 类 : MapFunctionality 与 QueryFunctionality。 

MapFunctionality 主要 展现 资源 的 地 图 能 力 ， 比 如 输出 地 图 图 片 ， 改 变 地 图 范围 ， 设 置地 图 中 图 层 
的 可 见 性 等 。 而 QueryFunctionality 主要 展现 资源 的 数据 的 空间 和 属性 查询 能 力 。 


4. Web ADF 中 如 何 使 用 公有 API? 


如 上 所 述 ， 不 同 的 数据 源 都 有 相应 的 类 来 实现 上 面 的 基本 接口 ， 那 我 们 来 看 看 ArcGIS Server 
Local 数据 源 的 相应 的 实现 类 : 


DD IGlISDataSouce: GISDataSouceLocal 
LU IGISResouce: MapResouceLocal. GeocodeResouceLocal 
OD IGISFunctionalit: MapFunctionality. QueryFunctionality 


这 就 是 Web ADF 的 优势 所 在 ， 它 可 以 使 得 各 种 不 同 的 数据 源 都 展现 为 资源 ， 使 得 它们 可 以 以 
相同 的 方式 得 到 使 用 。 对 于 控件 而 言 ， 每 个 资源 就 像 一 个 图 层 ， 而 不 管 数据 源 是 什么 。 

就 举 一 个 地 图 放大 的 功能 ， 一 个 地 图 控件 中 有 两 个 数据 源 ， 一 个 是 ArcGIS Server Local， 一 个 
是 ArcIMS， 地 图 的 范围 重新 设 定 了 之 后 ， 控 件 都 通过 每 个 资源 提供 的 MapFunctionality 给 每 个 资 
源 重 新 设 定 范围 , 每 个 资源 输出 这 个 新 的 地 图 。 而 地 图 控件 负责 把 这 些 输出 图 片 显 示 在 同一 个 界面 
上 ， 如 图 4.17 所 示 。 对 于 控件 而 言 ， 每 个 资源 就 像 一 个 图 层 。 从 资源 可 以 到 达 数 据 源 本 身 。 
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图 4.17 多 个 数据 源 的 地 图 显示 
上 面 这 些 文字 可 能 刚 开 始 看 起 来 比较 费劲 ， 但 是 对 于 使 用 ArcGIS Server 开发 的 人 员 来 说 一 定 
要 和 弄 清楚 这 些 关 系 。 我 们 这 里 总 结 一 下 ， 可 以 将 该 多 源 Web ADF 包括 的 类 划分 为 三 类 ， 分 别 是 : 
O 自 定义 ASP.NET Web 控件 ; 
口 公有 API， 包 括 公 有 数据 源 、 资 源 与 功能 类 ; 
O 数据 源 特 有 API 


4.2.2 与 Web 应 用 程序 框架 相关 的 安装 内 容 


Web ADF 安装 主要 包含 三 个 部 分 ， 第 一 个 是 组 件 ， 第 二 个 是 与 Visual Studio 集成 相关 内 容 ， 
第 三 个 是 一 些 帮助 文档 。 
Web ADF 相关 组 件 又 包含 不 同 部 分 ， 分 别 如 下 : 


(1) Web ADF .NET 程序 集 

这 些 程序 集 位 于 ArcGIS 安装 路 径 的 DotNet 文件 夹 (默认 安装 路 径 为 C:\Program 
Files\ArcGIS\DotNet) ， 主 要 内 容 如 图 4.18 所 示 。 包 含 Web ADF 的 控件 、API 以 及 数据 源 的 实现 ， 
还 包含 了 ArcIMS API 与 ArcGIS Server SOAP API。 


(S]ESRL ArcGIS. ADF. ArcGISServer.dil 
ESRI. ArcGIS.ADF ,ArcGISServer.Editor.dii 


ESRI. ArcGIS. ADF IMS. dii 
ESRI. ArcGIS.ADF Tasks.dl 
ESRI. ArcGIS. ADF 'Web.DakaSources. ArcG[SServer .di 


[S] ESRI.ArcGIS. ADF Web. DakaSources.ArcWebService.dl 
ESRI.ArcGIS.ADF Web.DataSources.dii 


ESPI.ArcGIS.ADE Web.DataSources. Graphics dll 

[S] ESRL.ArcGIS. ADF Web.DataSources. IMS. dii 

S ESRI. ArcGIS. ADF Web. DataSources.OGCWMSService. dl 
ESRI.ArcGIS.ADF Web.dli 
ESRI. ArcGIS.ADF Web. UI WebConitrols.dil 


图 4.18 Web ADF NET 程序 集 主要 内 容 
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(2) ArcObjects .NET 互 操作 程序 集 与 COM HRE 

由 于 ArcObjects 是 一 系列 的 COM 组 件 ， 因 此 需要 一 些 NET 互 操作 程序 集 才能 正常 访问 这 些 
组 件 。NET 程序 集 位 于 ArcGIS 安装 路 径 的 DotNet 文件 夹 中 , 而 COM 对 象 库 位 于 ArcGIS 安装 路 
径 的 com 文件 夹 ， 内 容 如 图 4.19 所 示 。 


(SESRLArcGIS.Geometry dll [EjesriGeometry.olb 
5] ESRLAxcGIS. Display dll [eesriDisplay.olb 

5] ESRLArcGIS.Server.dll [esesriserveroro 
(5]ESRLArcGIS. Output dll [es esrioutput.oro 

[35] ESRLArcGIS.Geodatabase dll | 国 esriGeoDatabase.olb 


图 4.19 ArcObjects .NET 互 操作 程序 集 与 COM 对 象 库 的 主要 内 容 


(3) JavaScript 库 与 客户 端 支持 文件 

这 些 文件 用 于 支持 客户 端 〈 即 浏览 器 ) 使 用 Web ADF 控件 ， 包 括 JavaScript 文件 、 图 片 以 及 
样式 表 ， 位 于 IS 根 路 径 (通常 为 cNnetpubwwwroot) 的 aspnet client 文件 夹 中 。 多 源 (9.2) Web 
ADF 支持 文件 位 于 ESRI 文件 夹 中 ,而 单 源 (9.09.10 文件 位 于 esri_arcgis_server_ webcontrols 文件 
夹 中 。aspnet_client 文件 夹 内 容 如 图 4.20 所 示 。 


BD aspnet_client 
= 
BD WebADF 
© images 
O JavaScript 


3 styles 
田 O Toolbar 
E O treeimages 


SIS qam 


O YebFornms 
S Ò esri_arcgis_server_webcontrols 
田 È system web 


图 4.20 aspnet_client 文件 夹 的 内 容 


与 Visual Studio 集成 的 内 容 主要 包括 位 于 工具 箱 中 的 一 系列 的 Web ADF 控件 、Web 地 图 应 用 
模板 、 集 成 的 帮助 系统 以 及 一 些 属性 设置 对 话 框 。 

帮助 文档 集成 在 Visual Studio 中 的 文档 之 中 , 除 此 之 外 , 还 包含 有 一 些 实例 代码 , 位 于 ArcGIS 
安装 路 径 的 DeveloperKit\SamplesNET\Server 文件 夹 中 。 


4.3 ”部 分 页 面 刷新 的 实现 一 一 Ajax 


在 ASP.NET 网 页 的 默认 模型 中 ， 单 击 按钮 或 执行 一 些 其 他 操作 会 导致 回 发 ， 此 时 将 重新 创建 
页 及 其 控件 ， 并 在 服务 器 上 运行 页 代码 ， 且 新 版 本 的 页 被 呈现 到 浏览 器 。 但 是 ， 在 有 些 情况 下 ， 需 
要 从 客户 端 运行 服务 器 代码 ， 而 不 执行 回 发 。 如 果 页 中 的 客户 端 脚本 维护 一 些 状 态 信息 〈 例 如 局 部 
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变量 值 ) ， 那 么 发 送 页 和 获取 页 的 新 副本 就 会 损坏 该 状态 。 此 外 ， 页 回 发 会 导致 处 理 开销 ， 这 会 降 
低 性 能 ， 且 会 让 用 户 不 得 不 等 待 处 理 并 重新 创建 页 。 

若 要 避免 丢失 客户 端 状态 并 且 不 导致 服务 器 往返 的 处 理 开销 , 可 以 使 用 客户 端 回调 。 在 客户 端 
回调 中 ， 客 户 端 脚本 函数 会 向 ASPNET 网 页 发 送 一 个 请 求 。 该 网 页 运行 其 正常 生命 周期 的 修改 版 
本 一 一 初始 化 页 并 创建 其 控件 和 其 他 成 员 , 然后 调用 特别 标记 的 方法 。 该 方法 执行 代码 中 编写 的 处 
理 过 程 ,然后 向 浏览 器 返回 可 由 另 一 客户 端 脚 本 函数 读 取 的 值 。 在 此 过 程 中 , 该 页 一 直 驻 留 在 浏览 
器 中 。 
回调 使 用 了 一 系列 的 标准 技术 ， 这 些 技术 统称 为 Ajax (Asynchronous JavaScript and XML， 异 
步 JavaScript 和 XML) 。 


4.3.1 Ajax 技术 


Ajax 本 身 并 不 是 一 项 新 技术 , 而 是 由 JavaScript. XML, XSLT, CSS. DOM 和 XMLHttpRequest 
等 多 种 技术 组 成 的 。 下 面 是 Ajax 应 用 程序 所 用 到 的 一 些 基本 技术 : 

O HTML 一 一 用 于 建立 Web 表单 并 确定 应 用 程序 其 他 部 分 使 用 的 字段 ; 

Q JavaScript ——JavaScript 代码 是 运行 Ajax 应 用 程序 的 核心 代码 ， 帮 助 改进 与 服务 器 应 用 


程序 的 通信 ; 

口 DHTML 或 Dynamic HITML 一 一 用 于 动态 更 新 表单 。 我 们 将 使 用 div. span 和 其 他 动态 
HTML 元 素来 标记 HTML; 

Q 文档 对 象 模型 DOM 一 一 用 于 (通过 JavaScript 代码 ) 处 理 HTML 结构 和 ( 某 些 情况 下 ) 
服务 器 返回 的 XML. 


4.3.2 Ajax 及 XMLHttpRequest 对 象 原理 


Ajax 的 原理 简单 来 说 通过 XMLHttpRequest 对 象 来 向 服务 器 发 异步 请 求 ， 从 服务 器 获得 数据 ， 
然后 用 Javascript 来 操作 DOM 而 更 新 页 面 。 这 其 中 最 关键 的 一 步 就 是 从 服务 器 获得 请 求 数据 。 要 
清楚 这 个 过 程 和 原理 ， 我 们 必须 对 XMLHttpRequest 有 所 了 解 。 

XMLHttpRequest 是 Ajax 的 核心 机 制 , 它 是 在 正 5 中 首先 引入 的 , 是 一 种 支持 异步 请 求 的 技术 。 
简单 的 说 ， 也 就 是 Javascript 可 以 及 时 向 服务 器 提出 请 求 和 处 理 响应 ， 而 不 阻塞 用 户 ， 达 到 无 刷新 
的 效果 。 

所 以 我 们 先 从 XMLHttpRequest 讲 起 ， 来 看 看 它 的 工作 原理 。 

首先 ， 我 们 先 来 看 看 XMLHttpRequest 这 个 对 象 的 属性 。 它 的 属性 有 : 


onreadystatechange， 每 次 状态 改变 所 触发 事件 的 事件 处 理 程序 ; 

responseText， 从 服务 器 进程 返回 数据 的 字符 串 形式 ; 

responseXML， 从 服务 器 进程 返回 的 DOM 兼容 的 文档 数据 对 象 ; 

status， 从 服务 器 返回 的 数字 代码 ， 比 如 常见 的 404 (未 找到 ) 和 200 (已 就 绪 ) F; 
statusText， 伴 随 状 态 码 的 字符 串 信 息 ; 
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口 readyState， 对 象 状 态 值 。 各 值 所 代表 的 意义 如 下 : 
0， 对 象 已 建立 ， 但 是 尚未 初始 化 (尚未 调用 open 方法 ) ; 
”1， 对 象 已 建立 ， 尚 未 调用 send 方法 ; 
X 2, send 方法 已 调用 ， 但 是 当前 的 状态 及 http 头 未 知 ; 
X 3, 已 接收 部 分 数据 , 因为 响应 及 http 头 不 全 , 这 时 通过 responseBody 和 responseText 
获取 部 分 数据 会 出 现 错误 ; 
X 4, 数据 接 收 完毕 ， 此 时 可 以 通过 通过 responseXML 和 responseText 获取 完整 的 回应 
数据 。 

XMLHttpRequest 仅仅 用 来 向 服务 器 发 出 一 个 请 求 的 ， 它 的 作用 也 局 限于 此 ， 但 它 的 作用 是 整 
个 Ajax 实现 的 关键 ,因为 Ajax 无 非 是 两 个 过 程 ， 发 出 请 求 和 响应 请 求 。 并 且 它 完全 是 一 种 客户 端 
的 技术 。 而 XMLHttpRequest 正 是 处 理 了 服务 器 端 和 客户 端 通信 的 问题 所 以 才 会 如 此 的 重要 。 

可 以 把 服务 器 端 看 成 一 个 数据 接口 , 它 返 回 的 是 一 个 纯 文本 流 , 当然 , 这 个 文本 流 可 以 是 XML 
格式 ， 可 以 是 Html， 可 以 是 Javascript 代码 ， 也 可 以 只 是 一 个 字符 串 。 这 时 候 , XMLHttpRequest 
向 服务 器 端 请 求 这 个 页 面 ， 服 务 器 端 将 文本 的 结果 写 入 页 面 ， 这 和 普通 的 web 开发 流程 是 一 样 的 ， 
不 同 的 是 ， 客 户 端 在 异步 获取 这 个 结果 后 ， 不 是 直接 显示 在 页 面 ， 而 是 先 由 Javascript 来 处 理 ， 然 
后 再 显示 在 页 面 。 至 于 现在 流行 的 很 多 Ajax 控件 ， 比 如 MagicaJax 等 ， 可 以 返回 DataSet 等 其 他 数 
据 类 型 ， 只 是 将 这 个 过 程 封装 了 的 结果 ， 本 质 上 他 们 并 没有 什么 太 大 的 区 别 。 


人 


4.3.3 用 XMLHttpRequest 来 实现 Ajax 


下 面 我 们 通过 一 个 实例 来 演示 如 何 利 用 XMLHttpRequest 来 实现 Ajax. 代码 工程 对 应 的 文件 夹 
名 为 SimpleAjax。 

新 建 一 个 C# 文 件 系统 的 Web 站 点 ， 命 名 为 SimpleAjax。 实 例 使 用 了 SQL Server Express 数据 
E, 数据 库 中 包含 一 个 数据 表 , 表 名 为 Items。 数 据 表 中 包含 的 字段 有 ItemID, ItemName 与 Quantity; 
分 别 代表 货物 标识 、 货 物 名 称 与 仓储 量 。 该 数据 库 数 据 在 工程 的 App Data 文件 夹 中 。 

在 Web.Config 文件 中 加 入 如 下 设置 连接 字符 串 代码 : 


<connectionStrings> 
<add name="Items" 
connectionString="Data Source=.\SQLEXPRESS; 
AttachDbFilename=|DataDirectory|\Items.mdf; 
Integrated ecurity=True; 
User Instance=True" 
providerName="System.Data.SqlClient" /> 
</connectionStrings> 


在 默认 的 页 面 Default.aspx 中 加 入 一 SqlDataSource 控件 ， 代 码 如 下 : 


<asp:SqlDataSource ID-"SqlDataSourcel" runat="server" 
ConnectionString-"«$$ ConnectionStrings:Items %>" 
SelectCommand-" SELECT [ItemID], [ItemName] FROM [Items]"» 
«/asp:SqlDataSource» 
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然后 在 Default.aspx 中 加 入 一 个 标签 、 一 个 列表 框 以 及 一 个 div， 代 码 如 下 : 


<label for-"ItemList" accesskey-"I"» 
货物 名 称 : </Label> 
<asp:ListBox runat-"server" ID-"ItemList" 
DataSourceID-"ItemsSource" DataTextField-"ItemName" 
DataValueField-"ItemID" EnableViewState-"False"»«/asp:ListBox^ 
«div» 
<span id-"ItemQuantityDisplay"»«/span» 
<span id-"ProgressDisplay" style="display: none"> 
<img src="images/loading.gif" alt="Loading" /> 
检查 仓储 量 . . .</span> 


«/div» 


为 了 使 用 JavaScript 来 获取 货物 的 仓储 量 ， 需 要 在 Web 站 点 提供 一 个 URL。 最 直接 的 方式 是 
通过 HTTP 的 GET 协议 来 访问 ASPNET 的 Web 服务 。 该 方式 的 URL 形式 为 : 


http: //hostname/path/«webservice»/«methodname»?«name1»-«valuel»&«name2»- 
«value2» 


需要 在 Web.Config 文件 的 <webServices> 节 中 加 入 配置 ， 才 能 使 用 HTTP GET 方式 访问 
ASPNET 的 Web 服务 ， 配 置 代 码 如 下 : 


<webServices> 
<protocols> 
<add name="HttpGet"/> 
</protocols> 
</webServices> 


下 面 需要 我 们 创建 一 个 Web 服务 来 提供 一 个 方法 ， 用 于 获取 一 货物 的 仓储 量 。 在 当前 站 点 中 
增加 一 个 名 为 WarehouseService 的 Web 服务 ， 在 其 中 增加 一 个 GetItemQuantity 方法 ， 代 码 如 下 : 


[WebMethod] 
public int GetItemQuantity(string itemID) ( 
if (String.IsNullOrEmpty (itemID)) 
return 0; 
System.Threading.Thread.Sleep (500); 
using (SqlConnection conn - new SqlConnection( 
WebConfigurationManager.ConnectionStrings ["Items"].ConnectionString)) 
using (SqlCommand cmd = new SqlCommand( 
"SELECT [Quantity] FROM Items WHERE [ItemID] = GitemID", conn)) { 
conn.Open () 
cmd.Parameters.AddWithValue ("@itemID", new Guid(itemID)); 
return (int)cmd.ExecuteScalar(); 


) 


假设 该 Web 服务 位 于 本 计算 机 上 ， 想 要 获取 仓储 量 的 货物 的 ID 为 1， 那 么 可 以 使 用 如 下 的 
URL 来 实现 : 


http://localhost/WareHouseService.asmx/GetItemQuantity?itemID=1 
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EIR URL 将 返回 如 下 形式 的 响应 : 
<int xmlns="..”>85</int> 


余下 来 要 完成 的 是 使 用 JavaScript 与 服务 器 进行 异步 通讯 。 在 我 们 这 里 主要 是 处 理 列表 框 
ItemList 控件 的 选择 项 改变 事件 。 这 些 JavaScript 代码 可 以 嵌 在 页 面 文件 中 或 放 在 另 一 个 单独 的 文 
件 中 。 由 于 通常 这 些 脚 本 内 容 很 多 ， 因 此 通常 宜 放 在 单独 文件 中 。 

在 当前 站 点 中 加 入 名 为 ScriptLibrary 的 文件 夹 ,并 在 该 文件 夹 中 加 入 名 为 SimpleAjaxExamplejs 
的 JavaScript 文件 。 该 文件 内 容 如 下 : 

var itemList, itemQuantityDisplay, progressDisplay; 

window.onload - function() ( 

itemList = document.getElementById ("ItemList"); 


itemQuantityDisplay = document.getElementById("ItemQuantityDisplay"); 
progressDisplay = document.getElementById ("ProgressDisplay"); 


if (!window.XMLHttpRequest) ( 
window.XMLHttpRequest = function (){ 
return new ActiveXObject ("Microsoft.XMLHTTP"); 


if (itemList.attachEvent) ( 
itemList.attachEvent("onchange", itemList OnChange); 
) 
else ( 
itemList.addEventListener("change", itemList OnChange, false); 


function itemList OnChange() ( 
if (l'itemList.value)( 
itemQuantityDisplay.style.display - "none"; 


var xr = new XMLHttpRequest (); 
xr.open("GET", "WarehouseService.asmx/GetlItemQuantity?itemID-"4 itemList. 
value, true); 
xr.onreadystatechange = function() { 
if (xr.readyState == 4) ( 
if (xr.status == 200) //Successful Request ( 
var doc = xr.responseXML; 
var qty; 


if (doc.evaluate) //XML Parsing in Mozilla { 
qty = doc.evaluate("//text()", doc, 
null, 
XPathResult.STRING TYPE, null).stringValue; 


else ( 
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//XML Parsing in IE 


qty = doc.selectSingleNode ("//text ()").data; 
y 


itemQuantityDisplay.innerHTML = "仓储 量 : " + qty; 
itemQuantityDisplay.className = ""; 
) 


else { 
itemQuantityDisplay.innerHTML = "获取 仓储 量 错误 "; 
itemQuantityDisplay.className = "Error"; 

} 

itemQuantityDisplay.style.display = ""; 


progressDisplay.style.display - "none"; 
) 
) 
xr.send (null); 
progressDisplay.style.display = ""; 
itemQuantityDisplay.style.display - "none"; 
) 
XMLHttpRequest 对 象 在 Internet Explorer 7.0, Mozilla Firefox, Opera ^j Safari 中 是 一 内 顽 对 象 ， 
在 Internet Explorer 6.0 中 可 作为 ActiveX 对 象 来 获取 。 为 处 理 这 些 不 同情 况 ， 需 要 使 用 如 下 的 
JavaScript 代码 处 理 : 
if (!window.XMLHttpRequest) { 


window.XMLHttpRequest = function() { 
return new ActiveXObject ("Microsoft.XMLHTTP"); 


) 


) 

该 代码 首先 检查 是 否 存在 XMLHttpRequest 对 象 ， 如 果 不 存在 ， 则 在 window 对 象 上 增加 一 个 
属性 。 

由 于 Mozilla Firefox 与 其 他 一 些 兼 容 W3C DOM 的 浏览 器 提供 名 为 addEventListener 方法 来 指 
定 处 理事 件 的 函数 ， 而 Internet Explorer 提供 的 方法 是 attachEvent， 因 此 我 们 为 ItemList 列表 框 控 
件 的 选择 项 改变 事件 增加 事件 处 理 器 的 代码 如 下 : 


if (itemList.attachEvent) { 
itemList.attachEvent ("onchange", itemList OnChange); 


} 
else { 
itemList.addEventListener("change", itemList OnChange, false); 


) 

上 述 代码 首先 检查 是 否 存在 attachEvent 方法 ， 如 果 存 在 ， 则 调用 attachEvent 方法 ， 否 则 调用 
addEventListener. 

主要 工作 是 在 itemList OnChange 函数 中 完成 的 。 在 该 函数 中 ， 可 看 到 使 用 XMLHttpRequest 
对 象 的 四 个 步骤 : 


(1) 初始 化 XMLHttpRequest 对 象 。 
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C2) 调用 XMLHttpRequest 对 象 的 open 方法 。 该 方法 的 第 一 个 参数 是 向 服务 器 提交 数据 的 类 
型 ， 即 POST 还 是 GET。 第 二 个 参数 是 请 求 的 URL 地 址 。 第 三 个 参数 是 传输 方式 ，false 为 同步 ， 
true 为 异步 。 默 认为 tue。 如 果 是 异步 通信 方式 ， 客 户 机 就 不 等 待 服务 器 的 响应 ; 如 果 是 同步 方式 ， 
客户 机 就 要 等 到 服务 器 返回 消息 后 才 去 执行 其 他 操作 。 

(3) 提供 处 理 onreadystatechange 事件 的 处 理 函数 。 当 XMLHttpRequest 对 象 的 状态 改变 时 就 


会 调用 该 处 理 函 数 。 
(4) 调用 send 方法 。send 方法 将 请 求 的 内 容 作为 一 字符 串 来 发 送 。 当 使 用 HTTP POST 方 始 
时 有 用 。 


当 HTTP 请 求 发 送 时 , 不 管 是 成 功 还 是 失败 , XMLHttpRequest 对 象 的 readyState 设置 为 4, 表 
示 发 送 完成 。 需 要 利用 返回 的 HTTP 状态 代码 来 判断 请 求 是 否 成 功 。 状 态 值 为 200 表示 成 功 。 一 旦 
请 求 完成 ， 可 使 用 responseXML (XML DOM 文档 ) 或 responseText (普通 文本 ) 属性 来 得 到 HTTP 
响应 。 

我 们 这 里 处 理 的 是 responseXML 属性 。 由 于 货物 的 仓储 量 保存 在 XML 文档 的 根 节点 ， 因 此 
XPATH 的 //text0 是 要 提取 的 内 容 。IE 与 Mozilla Firefox 浏览 器 使 用 XPath 提取 方法 有 所 不 同 。 在 
IE 中 ， 可 使 用 selectSingleNode 函数 ， 而 在 Mozilla 中 可 使 用 evaluate 函数 。 

运行 应 用 程序 。 当 用 户 从 列表 框 中 选择 某 货 物 后 ， 可 在 页 面 看 到 一 动画 效果 以 及 显示 的 “检查 
仓储 量 ...” 文 字 。 随 着 动画 消失 ， 即 可 看 到 显示 该 货物 的 仓储 量 或 是 一 错误 信息 。 如 图 421 所 示 。 
在 过 程 中 用 户 并 没有 看 到 页 面 闪烁 ， 该 过 程 即 称 为 持续 交互 。 
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图 4.21 程序 运行 效果 


这 种 持续 交互 是 需要 我 们 在 客户 端 写 大 量 的 代码 的 代价 换 来 的 。 幸运 的 是 , 这 些 客户 端 代码 可 
以 封装 为 平台 中 的 通用 代码 来 简化 。ASP.NET 中 的 回调 就 提供 了 一 个 基础 框架 ， 实 现在 客户 端 调 
用 服务 器 端的 代码 ， 也 就 是 我 们 下 一 小 节 要 介绍 的 内 容 。 


4.3.4 .NET 中 内 置 的 Ajax 


在 期 望 不 执行 回 发 而 从 客户 端 运 行 服务 器 代码 的 情况 下 ， 可 以 使 用 ClientScriptManager 类 来 
调用 客户 端 回 调 。 这 称 为 对 服务 器 执行 带 外 回调 。 在 客户 端 回调 中 ， 客 户 端 脚本 函数 向 ASP.NET 
网 页 发 送 异 步 请 求 。 网 页 修改 其 正常 生命 周期 来 处 理 回调 。 
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回调 的 过 程 如 下 所 示 : 


(1) 客户 端 发 出 请 求 ， 请 求 内 容 包括 : 指定 更 新 控件 和 传递 参数 。 
(2) 服务 端 响应 、 处 理 。 

G) 服务 端 将 处 理 后 的 内 容 以 字符 串 返 回 。 

(4). 客户 端 使 用 一 个 函数 接受 返回 值 。 

C5) 客户 端 更 新 指定 控件 。 

使 用 回调 的 步 又 如 下 : 


(1) 在 控件 或 Page 类 中 实现 ICallbackEventHandler 接口 。 该 接口 有 两 个 方法 ， 分 别 是 
RaiseCallbackEvent 和 GetCallbackResult。RaiseCallbackEvent 方法 是 回调 执行 的 方法 ， 该 方法 处 理 
回调 的 内 容 。 它 没有 返回 值 ,而 是 从 浏览 器 接受 一 个 字符 串 作 为 事件 的 参数 ， 即 该 方法 接受 客户 端 
JavaScript 所 传递 的 参数 。 注 意 它 是 首先 触发 的 。 接 下 来 触发 的 就 是 GetCallbackResult 方法 ， 它 将 
所 得 到 的 结果 传 回 给 客户 端的 脚本 。 

(2) 生成 调用 该 回调 的 客户 端 脚本 。 可 通过 调用 ClientScriptManager 类 的 
GetCallbackEventReference 方法 来 生成 。Page 类 的 ClientScript 属性 就 是 一 ClientScriptManager 类 
的 实例 。 

G) 编写 代码 调用 在 第 二 步骤 中 生成 的 客户 端 脚本 。 通 常 是 在 事件 处 理 器 中 完成 。 


还 是 来 实现 上 个 例子 的 内 容 。 首 先 在 站 点 中 加 入 一 个 名 为 CallbackExample 的 页 面 。 在 该 类 中 
加 入 如 下 代码 ， 实 现 ICallbackEventHandler 接口 。 


public partial class CallbackExample : 
System.Web.UI.Page, ICallbackEventHandler { 
string callbackResult; 


#region ICallbackEventHandler Members 


public string GetCallbackResult() ( 
return callbackResult; 


) 


public void RaiseCallbackEvent (string eventArgument) { 
try ( 
callbackResult = Warehouse.GetltemQuantity ( 
eventArgument).ToString(); 
) 
catch (Exception e) ( 
Trace.Write (e.Message); 


throw new Exception (" 检 查 仓储 量 失 败 ") ; 
} 


#endregion 


} 
RaiseCallbackEvent 方法 的 eventArgument 参数 从 客户 端 脚本 传 过 来 。 在 例子 中 ， 就 是 ItemList 
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列表 框 中 的 选项 ItemID。RaiseCallbackEvent 需要 实现 的 就 是 得 到 由 eventArgument 指定 的 货物 的 
仓储 量 ， 并 把 该 值 赋 给 页 面 中 的 一 个 字符 串 成 员 变量 。 我 们 需要 一 个 成 员 来 保存 结果 ， 并 在 
GetCallbackResult 方法 中 返回 该 变量 。 
下 一 步 要 实现 的 是 生成 调用 的 客户 端 脚本 。 可 在 Page 的 Load 事件 处 理 器 中 完成 ， 代 码 如 下 : 
protected void Page Load(object sender, EventArgs e) ( 


if (IsCallback) 
return; 


// 根据 传 入 的 参数 返回 实际 的 回调 脚本 

string callBackFunctionCall = 
ClientScript.GetCallbackEventReference ( 
this, 
"getSelectedItemID()", 
"onCallbackComplete", 
null, 
"onCallbackError", 
true 


no 


Page.ClientScript.RegisterClientScriptBlock( 
GetType(), 
"CallBack", 
"function DoClientCallBack() ( " * callBackFunctionCall + ") ", 
true 


) 
生成 客户 端 脚本 需要 两 个 步骤 。 首 先 需要 调用 GetCallbackEventReference， 该 方法 包含 六 个 参 


(1) 第 一 个 参数 是 实现 ICallbackEventHandler 接口 的 类 的 实例 ， 在 例子 中 就 是 Page 自身 。 
(2) 第 二 个 参数 是 从 客户 端 脚本 传递 到 服务 器 端的 RaiseCallbackEvent 方法 的 值 。 该 参数 应 
该 是 个 得 到 一 字符 串 的 JavaScript 表达 式 。 在 我 们 的 例子 中 ， 需 要 传递 的 是 列表 框 中 选择 的 值 。 因 
此 我 们 创建 一 个 名 为 getSelectedItemID 的 函数 ， 该 函数 返回 在 列表 框 中 选择 的 值 。 
G) 第 三 个 参数 是 一 个 客户 端 事件 处 理 程 序 的 名 称 ， 该 处 理 程序 接收 服务 器 端 
GetCallbackResult 返回 的 结果 。 
(4) 第 四 个 参数 是 与 回调 实例 关联 的 上 下 文 。 如 果 有 许多 回调 ， 那 么 可 以 用 该 参数 来 区 分 。 
该 参数 也 应 该 是 一 JavaScript 表达 式 。 
(5) 第 五 个 参数 是 客户 端 处 理 回调 失败 的 JavaScript 函数 的 名 称 。 
(6) 最 后 一 个 参数 指定 回调 是 同步 还 是 异步 。 由 于 我 们 希望 执行 异步 操作 ， 因 此 将 该 参数 的 
值 设置 为 true。 
当然 GetCallbackEventReference 方法 有 几 个 重 载 方法 ， 如 表 4-1 所 示 。 
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X 4-1 GetCallbackEventReference 方法 重 载 列表 


方法 


说 明 


GetCallbackEventReference 
(Control, String, String, String) 


GetCallbackEventReference 


(Control, String, String, String, 


Boolean) 
GetCallbackEventReference 


(Control, String, String, String, 


String, Boolean) 
GetCallbackEventReference 


(String, String, String, String, 


String, Boolean) 


获取 一 个 对 客户 端 函数 的 引用 ; 调用 该 函数 时 ， 将 启动 一 个 对 服务 器 端 
事件 的 客户 端 回 调 。 此 重 载 方法 的 客户 端 函 数 包 含 指定 的 控件 、 参 数 、 


客户 端 脚本 和 上 下 文 。 


获取 一 个 对 客户 端 函数 的 引用 ; 调用 该 函数 时 ， 将 启动 一 个 对 服务 器 端 
事件 的 客户 端 回调 。 此 重 载 方法 的 客户 端 函数 包含 指定 的 控件 、 参 数 、 


客户 端 脚本 、 上 下 文 和 布尔 值 。 
获取 一 个 对 客户 端 函数 的 引用 


调用 该 函数 时 ， 将 启动 一 个 对 服务 器 端 


事件 的 客户 端 回调 。 此 重 载 方法 的 客户 端 函数 包含 指定 的 控件 、 参 数 、 


客户 端 脚本 、 上 下 文 、 
获取 一 个 对 客户 端 函数 的 引用 


错误 处 理 程序 和 布尔 值 。 
调用 该 函数 时 ， 将 启动 一 个 对 服务 器 端 


事件 的 客户 端 回 调 。 此 重 载 方法 的 客户 端 函 数 包含 指定 的 目标 、 参 数 、 
客户 端 脚本 、 上 下 文 、 错 误 处 理 程序 和 布尔 值 。 我 们 就 整个 程序 作 个 系 
统 的 说 明 ， 并 且 列 出 前 台 的 页 面 代码 和 后 台 的 逻辑 代码 ， 这 样 可 以 使 得 


你 对 程序 有 个 直观 的 理解 。 


从 GetCallbackEventReference 方法 返回 的 值 是 一 异步 调用 服务 器 的 JavaScript 表达 式 。 将 该 值 
放 在 另 一 个 名 为 DoClientCallBack 的 JavaScript 函数 中 ， 然 后 通过 列表 框 的 选项 改变 事件 处 理 器 调 
用 该 函数 。 使 用 ClientScriptRegisterClientScriptBlock 方法 来 组 织 该 JavaScript 函数 并 注册 。 这 样 我 
们 就 完成 了 服务 器 端的 工作 ， 下 面 要 完成 的 是 客户 端 代 码 。 


客户 端 代码 如 下 : 


var itemList, itemQuantityDisplay, progressDisplay; 


window.onload = function() { 
itemList = document .getElementById("ItemList"); 
itemQuantityDisplay = document .getElementById("ItemQuantityDisplay"); 
progressDisplay = document.getElementById ("ProgressDisplay"); 


if (itemList.attachEvent) ( 
itemList.attachEvent ("onchange", itemList OnChange); 


) 


else ( 


itemList.addEventListener("change", itemList OnChange, false); 


) 
) 


function itemList OnChange() { 
document.getElementById("ProgressDisplay").style.display = ""; 
document.getElementById("ItemQuantityDisplay").style.display = "none"; 


DoClientCallBack(); 
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// 回调 成 功 
function onCallbackComplete (result, context) { 
progressDisplay.style.display = "none"; 


itemQuantityDisplay.className = ""; 
itemQuantityDisplay.style.display - ""; 
itemQuantityDisplay.innerHTML = result + " in stock"; 


) 


// 回调 错误 
function onCallbackError() ( 
progressDisplay.style.display - "none"; 


itemQuantityDisplay.className - "Error"; 
itemQuantityDisplay.style.display - ""; 
itemQuantityDisplay.innerHTML = "Error retrieving quantity"; 


} 


function getSelectedItemID() { 
return itemList.value; 
} 
该 页 面 的 用 户 交互 与 前 面 一 小 节 的 页 面 是 一 样 的 , 但 是 代码 大 大 减少 了 , 因为 我 们 不 需要 编写 
代码 来 解析 XML 或 处 理 XMLHttpRequest 对 象 。 


4.3.5 ArcGIS Web 应 用 开发 框架 中 的 Ajax 


ESRI ArcGIS Server 9.2 的 Web 应 用 开发 框架 充分 利用 了 ASP.NET 中 的 回调 技术 。 我 们 来 看 
看 利用 Visual Studio 模板 创建 的 默认 应 用 程序 中 如 何 利 用 回调 的 。 


首先 看 到 默认 的 主页 面 Defaultaspx 对 应 的 类 WebMapApplication 实现 了 
ICallbackEventHandler 接口 。 

我 们 再 以 Identify 工具 来 深入 了 解 应 用 开发 框架 。 

在 WebMapApplication 类 的 Load 事件 处 理 器 中 ， 调 用 new MapIdentify(Map1) 初 始 化 
Identify 工具 。 在 MapIdentify 类 的 构造 函数 中 ， 调 用 了 SetupIdentify 方法 。 该 方法 首先 通过 调 
用 GetCallbackEventReference 方法 生成 客户 端 脚本 , 然后 调用 RegisterClientScriptBlock 注册 一 个 名 
为 identifyCallbackFunctionString 的 JavaScript 函数 ， 该 函数 中 调用 生成 的 客户 端 脚本 。 

在 display mapidentifyjs 文件 的 MapIdClick 函数 (Identify 事件 处 理 器 ) 中 调用 了 
identifyCallbackFunctionString 函数 ， 从 而 触发 了 webMapApplication 类 的 RaiseCallbackEvent 
方法 。 

RaiseCallbackEvent 方法 不 仅 需 要 处 理 Identify 工具 , 还 需要 处 理 其 他 工具 , 本 实例 中 包括 关闭 
应 用 程序 与 获取 版 权 文本 。 为 了 在 该 方法 中 判断 是 哪个 工具 启动 了 该 方法 调用 , 需要 在 传 入 在 参数 
中 包含 表明 调用 “身份 ”。 同 时 由 于 在 传 入 参数 中 还 需要 其 他 可 能 更 多 的 信息 , 例如 Identify TH, 
不 仅 需 要 表明 调用 者 身份 的 信息 ， 还 需要 当前 用 户 单 击 处 X. Y 坐标 信息 。 为 了 能 在 
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RaiseCallbackEvent 方法 中 把 这 些 信息 都 解释 出 来 ， 本 实例 使 用 的 是 
“参数 名 = 参数 值 & 参 数 名 = 参数 值 ” 
式 。 例 如 在 MapIdClick 函数 中 传 入 的 是 


"ControlID-Mapl &ControlType-Map&EventArg-Mapldentify&Mapl mode=MapIdentify&minx=" + zleft + 
"&miny-" + ztop. 


而 在 RaiseCallbackEvent 方法 中 ， 通 过 调用 Split("&".ToCharArray() 方 法 将 各 个 “参数 名 = 参数 值 ” 
放置 到 一 组 数列 中 ， 然 后 再 通过 下 面 的 代码 将 “参数 名 ”与 “参数 值 ”分 开 : 


if (keyValuePairs.Length > 0) ( 
for (int i = 0; i < keyValuePairs.Length; i++) ( 
keyValue = keyValuePairs.GetValue(i).ToString().Split( 
"-".ToCharArray()); 
m queryString.Add(keyValue[0], keyValue[1]); 
) 
} 
else ( 
keyValue = responseString.Split("-".ToCharArray()); 
if (keyValue.Length » 0) 
m queryString.Add(keyValue[0], keyValue[1]); 
) 


通过 执行 上 述 的 代码 后 ， 只 需要 调用 m_queryString["EventArg"] 就 能 判断 是 哪个 工具 启动 该 方 
法 的 调用 。 如 果 是 Identify 工具 ， 那 么 该 值 为 MapIdentify。 

在 判断 出 调用 工具 是 Identify 后 ，RaiseCallbackEvent 方法 调用 MapIdentify 类 的 Identify 方法 
得 到 返回 值 。 


44 自 定义 工具 与 命令 


前 面 所 介绍 的 开发 ， 不 管 是 使 用 Web Mapping Application 模板 还 是 直接 使 用 Web 控件 ， 使 用 
的 都 是 Web ADF 中 封装 好 的 工具 与 命令 ， 例 如 地 图 放大 、 缩 小 、 漫 游 。 然 而 在 实际 项 目 应 用 中 ， 
需要 的 功能 远 远 不 仅 如 此 ， 至 少 还 需要 通过 图 形 查 询 属性 (点 查询 、 和 矩形 查询 、 多 边 形 查 询 等 ) 或 
是 通过 属性 查询 图 形 。 因 此 ， 如 何在 工具 条 中 增加 新 的 自 定义 工具 是 ArcGIS Server 开发 者 面临 的 
第 一 个 问题 。 
下 面 我 们 通过 开发 图 形 查 询 属性 功能 来 介绍 如 何 自 定义 工具 与 命令 。 按 照 4.1.3 节 介绍 的 方法 
创建 一 个 同样 的 Web 应 用 程序 ， 将 其 工程 名 称 命名 为 CustomTool。 

为 了 使 实例 更 接近 实际 的 应 用 ， 也 为 了 介绍 如 何 蔡 换 Web ADF 自身 附带 的 图 标 与 样式 文件 ， 
书 中 使 用 了 自己 设计 的 一 套图 标 与 样式 文件 。 读 者 可 以 从 本 书 随 附 的 源 代码 文件 〈 该 文件 可 从 
www.booksaga.com 网 站 下 载 ) 的 CustomTool 工程 中 找到 相应 的 资源 ， 并 拷贝 到 对 应 的 目录 中 。 例 
如 图 标 文 件 请 拷贝 到 工程 的 Images Toolbar 子 文件 夹 中 ， 样 式 文件 拷贝 到 工程 的 css 子 文件 夹 中 。 
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441 在 工具 栏 中 增加 按钮 


要 增加 工具 或 命令 ， 第 一 步 当然 是 要 在 界面 的 工具 栏 中 增加 一 个 按钮 。 

由 于 书 中 提供 的 图 标 中 每 个 都 带 有 描述 ， 因 此 不 再 需要 描述 信息 。 首 先 需要 将 工具 栏 控件 
Toolbar1 的 ToolbarStyle 的 属性 由 ImageAndText 设置 ImageOnly, 表示 在 工具 栏 中 只 显示 工具 按钮 
指定 的 图 标 ， 而 不 需要 文字 描述 。 

通过 属性 设置 面板 打开 Toolbarl 控件 的 ToolbarItems 属性 设置 对 话 框 ToolbarCollectionEditorForm， 
并 通过 Show Properties 按钮 展开 对 话 框 的 属性 设置 部 分 ， 如 图 4.22 所 示 。 


Àj ToolbarCollectionEditorForm 


Toolbar Items: Current Toolbar Contents Properties: 
| Tool aIn FRIE] 
| Command TE MapZoomDut a Di sabledInsge 
DropDownBox ELM Hoverlmage — "/Images/T: 


Separator opFullExtent Move Down SelectedInsg: "/Images/T. 


Space TS MepTdenti fy E Co es "s 

由 G har Navigation Tedfiy pet 
ClientAction DragRectan, 
JavaScriptFi] 

El General 
BuddyIten 
Hide Properties: Cursor 
Disabled False 
WapZoonIn 


e 
Nane of the Toolbar Iten. 


图 4.22 ”通过 ToolbarCollectionEditorForm 对 话 框 控制 工具 栏 中 工具 或 命令 按钮 


首先 在 对 话 框 的 左边 窗口 中 选择 Tool， 然 后 选择 Add 按钮 便 可 增加 一 个 工具 按钮 ， 将 其 命名 
为 MapIdentify。 

通过 对 话 框 右 部 的 属性 设置 窗口 ， 将 原来 几 个 Web ADF 提供 的 工具 按钮 以 及 新 增加 的 工具 按 
钮 的 DefaultImage, HoverImage ^ SelectedImage 属性 设置 为 我 们 对 应 的 图 标 所 在 目录 的 相对 路 径 。 

另 一 个 更 直接 但 需要 一 些 经 验 的 方式 是 直接 修改 Defaultaspx 中 <esri:Toolbar> 与 
</esri:Toolbar> 之 间 的 代码 。 修 改 后 的 代码 如 下 : 


Xesri:Toolbar ID-"Toolbarl" runat="server" 
BuddyControlType-"Map" Group-"Toolbarl Group" 
Height-"50px" Width-"198px" 
WebResourceLocation-"/aspnet client/ESRI/WebADF/" 
ToolbarStyle-"ImageOnly"» 


<ToolbarItems> 
Xesri:Tool ClientAction-"DragRectangle" Name-"MapZoomIn" 
DefaultlImage-"-/Images/Toolbar/zoomin 1.jpg" 
HoverImage-"-/Images/Toolbar/zoomin 2.jpg" 
SelectedImage-"-/Images/Toolbar/zoomin 3.jpg" 
ServerActionAssembly-"ESRI.ArcGIS.ADF.Web.UI.WebControls" 
ServerActionClass-"ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools.MapZoomIn" 
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Text-"Zoom In" ToolTip=" 放 大 显示 地 图 " /> 
<esri:Tool ClientAction-"DragRectangle" Name-"MapZoomOut" 
DefaultlImage-"-/Images/Toolbar/zoomout 1.jpg" 
HoverImage-"-/Images/Toolbar/zoomout 2.jpg" 
SelectedImage-"-/Images/Toolbar/zoomout 3.jpg" 
ServerActionAssembly-"ESRI.ArcGIS.ADF.Web.UI.WebControls" 
ServerActionClass-"ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools.MapZ 
oomOut" 
Text-"Zoom Out" ToolTip=" 缩 小 显示 地 图 ” /> 
Xesri:Tool ClientAction-"DragImage" Name-"MapPan" 
DefaultImage-"-/Images/Toolbar/pan 1.jpg" 
HoverImage-"-/Images/Toolbar/pan 2.jpg" 
SelectedImage-"-/Images/Toolbar/pan 3.jpg" 
ServerActionAssembly-"ESRI.ArcGIS.ADF.Web.UI.WebControls" 
ServerActionClass-"ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools.MapP 
an" 
Text-"Pan" ToolTip=" 漫 游 " /> 
Xesri:Command ClientAction-"" Name-"MapFullExtent" 
DefaultImage-"-/Images/Toolbar/fullextent 1.jpg" 
HoverImage-"-/Images/Toolbar/fullextent 2.jpg" 
SelectedImage-"-/Images/Toolbar/fullextent 3.jpg" 
ServerActionAssembly-"ESRI.ArcGIS.ADF.Web.UI.WebControls" 
ServerActionClass-"ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools.MapF 
ullExtent" 
Text-"Full Extent" ToolTip=" 全 图 显示 " /> 
Xesri:Tool ClientAction-"Point" Name-"MapIdentify" 
DefaultImage-"-/Images/Toolbar/identify 1.jpg" 
HoverImage-"-/Images/Toolbar/identify 2.jpg" 
SelectedImage-"-/Images/Toolbar/identify 3.jpg" 
ServerActionAssembly-"App Code" 
ServerActionClass-"IdentifyPoint" 
Text-"Identify" ToolTip=" 点 查询 " /> 
</ToolbarItems> 
<BuddyControls> 
<esri:BuddyControl Name="Map1" /> 
</BuddyControls> 


</esri:Toolbar> 


从 上 面 的 代码 我 们 可 以 看 出 在 工具 栏 中 有 两 类 按钮 ,一 类 称 为 ToolCT HO, 另 一 类 为 Command 

〈 命 令 ) 。 它 们 之 间 的 区 别 在 于 ,工具 需要 用 户 与 地 图 交互 , 例如 放大 工具 需要 用 户 在 地 图 上 用 鼠 

标 拖 出 一 个 矩形 框 后 才能 执行 放大 操作 ， 而 命令 则 不 要 用 户 与 地 图 交互 , 可 直接 执行 操作 , 例如 全 
图 显示 命令 不 需要 用 户 在 地 图 上 有 任何 操作 ， 而 直接 执行 显示 整个 范围 地 图 的 操作 。 

在 工具 与 命令 按钮 的 属性 中 ，Defaulthmage、HoverImage 与 SelectedImage 分 别 表示 正常 状态 、 
鼠标 移动 到 该 按钮 上 的 状态 以 及 选择 状态 时 所 使 用 的 图 标 所 在 的 相对 于 Default.aspx 文件 的 相对 路 
径 。 

ClientAction 属性 表示 该 工具 需要 用 户 与 地 图 交互 的 类 型 ， 可 选 的 值 有 Point、Line、PolyLine、 
Polygon, Circle, Oval, DragRectangle 与 DragImage。 
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ServerActionAssembly 属性 表示 当 用 户 选 择 该 了 工具 或 命令 ， 并 且 与 地 图 交互 完毕 后 (命令 按 
钮 不 需要 用 户 与 地 图 交互 ) ， 服 务 器 端 执行 的 代码 所 在 的 程序 集 的 名 称 。 而 ServerActionClass 属性 
表示 该 代码 所 在 的 类 的 名 称 。 例 如 上 面 的 放大 、 缩 小 、 漫 游 与 全 图 显示 都 执行 的 代码 都 在 
ESRI.ArcGIS.ADF.Web.UI.WebControls 程序 集中 ， 分 别 对 应 MapZoomIn、MapZoomOut、MapPan 
与 MapFullExtent 类 。 

对 于 自 定义 的 工具 , 也 需要 使 用 ServerActionAssembly 与 ServerActionClass 属性 指出 服务 器 端 
代码 所 在 位 置 。 在 上 面 的 代码 中 指定 的 是 App_Code 文件 夹 中 的 IdentifyPoint 类 。 

实现 下 面 几 个 工具 要 编写 的 就 是 该 类 的 代码 。 


442 自 定义 点 查询 工具 


该 工具 要 实现 的 是 用 户 在 地 图 上 用 鼠标 通过 单 击 选择 某 地 物 要 素 后 , 弹出 一 网 页 显示 选择 要 素 
的 属性 ， 并 高 亮 显示 被 选择 的 要 素 。 为 了 简单 ,我 们 先 只 介绍 如 何 通过 点 查询 出 要 素 的 属性 ,在 下 
一 小 节 再 设置 高 亮 显示 。 

首先 通过 工程 的 右键 菜单 的 Add ASP.NET Folder 的 App Code 命令 ， 在 当前 工程 中 增加 
App Code 文件 夹 。ASP.NET 2.0 使 用 该 文件 夹 存放 应 用 程序 级 别 的 类 库 。 

然后 通过 右键 菜单 的 Add New Item 命令 , 在 App. Code 文件 夹 中 加 入 一 个 名 为 IdentifyPoint.cs 
的 文件 。 

在 IdentifyPoint 类 中 用 到 了 地 图 控件 、 点 对 象 等 ， 因 此 为 了 避免 使 用 全 路 径 来 调用 类 ， 
需要 在 IdentifyPoint 类 的 前 面 加 入 如 下 命名 空间 的 引用 : 

using ESRI.ArcGIS.ADF.Web; 

using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.DataSources; 

using ESRI.ArcGIS.ADF.Web.UI.WebControls; 

using ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools; 

自 定义 工具 类 必须 实现 IMapServerToolAction 接口 ， 需 要 增加 两 项 代码 。 一 个 是 在 类 声明 的 后 
面 加 入 IMapServerToolAction 接口 ， 另 一 个 是 需要 实现 IMapServerToolAction 接口 的 ServerAction 
方法 〈Visual Studio 可 以 在 增加 接口 名 称 时 自动 插入 该 方法 ) 。 因 此 该 类 代码 的 框架 如 下 : 

public class GraphicPointTool: IMapServerToolAction 

{ 

void IMapServerToolAction.ServerAction (ToolEventArgs args) 
{ 
) 

) 

现在 要 实现 的 是 在 ServerAction 方法 中 增加 代码 ， 实 现 查询 用 户 单 击 处 要 素 的 属性 。 该 方法 的 
args 参数 包含 了 用 户 单 击 处 的 屏幕 坐标 信息 , 从 该 参数 还 可 以 得 到 地 图 控件 的 引用 。 在 ServerAction 
方法 中 先 增加 如 下 代码 : 


// 从 方法 的 参数 中 得 到 地 图 控件 的 引用 


Map map = args.Control as Map; 
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// 从 方法 的 参数 中 得 到 用 户 单 击 位 置 的 点 
PointEventArgs pea = (PointEventArgs)args; 
System.Drawing.Point screen point = pea.ScreenPoint; 


需要 将 屏幕 像素 坐标 转换 到 地 图 坐标 ， 代 码 如 下 : 


Point point = Point.ToMapPoint (screen point.X, screen point.Y, 
map.Extent, (int)map.Width.Value, (int)map.Height.Value); 
下 面 需要 实现 的 是 利用 该 点 查询 要 素 。 要 实现 查询 ， 则 需要 判断 资源 是 否 具有 查询 功能 ， 代 码 
如 下 : 
IGISFunctionality gisfunc = map.GetFunctionality ("NorthAmericaMap"); 


if (gisfunc == null) 
return; 


IGISResource gisresource = gisfunc.Resource; 

bool supportquery - gisresource.SupportsFunctionality( 

typeof (IQueryFunctionality)); 

if (!supportquery) 

return; 

在 上 面 的 代码 中 首先 用 “NorthAmericaMap ” (地 图 资源 管理 器 中 包含 要 查询 图 层 的 资源 的 名 
称 ) 作为 参数 名 ， 调 用 地 图 对 象 的 GetFunctionality 方法 ， 得 到 该 资源 能 提供 的 功能 ， 如 果 该 功能 
对 象 不 为 空 ， 即 表示 能 提供 查询 、 地 图 显示 等 功能 ， 则 接着 执行 ， 否 则 直接 返回 。 然 后 调用 资源 对 
象 的 SupportsFunctionality 方法 判断 是 否 具 有 查询 功能 ， 如 果 没 有 查询 ， 则 直接 返回 。 如 果 有 ， 则 
调用 资源 对 象 的 CreateFunctionality 方法 得 到 查询 功能 对 象 ， 代 码 如 下 : 

IQueryFunctionality qfunc; 


qfunc = gisresource.CreateFunctionality( 
typeof(IQueryFunctionality), null) as IQueryFunctionality; 


得 到 查询 功能 对 象 后 ， 调 用 其 Identify 方法 执行 查询 ， 代 码 如 下 : 
System.Data.DataTable[] qdatatable = qfunc.Identify( 
null, point, 1, IdentifyOption.AllLayers, null); 

查询 功能 Identify 方法 的 第 一 个 参数 是 地 图 功能 名 称 ; 第 二 个 参数 是 查询 要 素 的 图 形 对 象 ， 第 
三 个 参数 是 误差 范围 ， 第 四 个 参数 是 查询 方式 ， 可 以 是 AllLayers、VisibleLayers 与 TopMostLayer 
三 个 值 之 一 , 分 别 表示 查询 所 有 图 层 、 查 询 可 见 图 层 与 查询 最 上 层 图 层 ; 第 五 个 参数 是 可 查询 图 层 
的 ID， 由 于 我 们 需要 对 所 有 图 层 查询 ， 所 以 该 值 可 使 用 null。 

至 此 点 对 象 查询 要 素 完 成 , 下 面 要 实现 的 是 以 网 页 的 方式 展现 查询 到 的 要 素 的 属性 。 代 码 如 下 : 


if (qdatatable == null) 
return; 


System.Data.DataSet dataset = new System.Data.DataSet(); 

for (int i = 0; i < qdatatable.Length; i++) ( 
dataset.Tables.Add(qdatatable[i]); 

} 

DataTableCollection dtc = dataset.Tables; 
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IdentifyHelper.ShowIdentifyResult (map, dtc); 

在 上 述 代码 中 ， 首 先 判断 qdatatable 是 否 为 空 ， 如 果 为 空 ， 直 接 返 回 。 如 果 不 为 空 ， 则 将 数组 
形式 的 qdatatable 转换 为 集合 形式 的 dic 变量 。 最 后 为 了 简化 代码 ， 也 为 了 代码 (其 他 查询 工 
具 也 会 利用 )， 将 显示 查询 结果 的 代码 放 到 了 IdentifyHelper 类 的 ShowIdentifyResult 方法 中 。 
该 方法 的 代码 如 下 : 

public static void ShowIdentifyResult (Map map, DataTableCollection dtc) 

t 


string returnstring - string.Empty; 
foreach (DataTable dt in dtc) ( 
if (dt.Rows.Count == 0) 
continue; 
returnstring += GetHtmlFromDataTable (dt); 


) 

returnstring = returnstring.Replace("NrMn", ""); 
returnstring = returnstring.Replace("Nin", ""); 

string functionValue = "var theForm = document.forms[0];"; 


functionValue += "theForm.FunctionValue.Value-'" + returnstring + "';"; 
functionValue += "open('IdentifyResult.htm', 'IdentifyResult');"; 
AddJavaScriptCallback (map, functionValue); 
) 
上 述 代码 调用 GetHtmlFromDataTable 方法 ， 实 现 从 数据 表 转 换 为 HTML 表格 格式 的 字符 串 。 
在 得 到 该 字符 串 后， 我 们 构造 了 一 段 JavaScript 代码 ， 该 段 JavaScript 代码 的 意思 是 将 该 字符 串 的 
值 赋 给 Defaultaspx 页 面 中 的 一 个 不 可 见 文本 框 FunctionValue， 然 后 调用 open 方法 弹出 
IdentifyResulthtm 网 页 。 最 后 调用 IdentifyHelper 类 的 AddJavaScriptCallback 方法 将 该 段 
JavaScript 代码 加 入 到 地 图 对 象 的 CallbackResults 属性 中 。 该 段 代 码 将 最 终 在 客户 端 〈 即 浏览 器 ) 
执行 。 
由 于 上 面 代码 需要 利用 文本 框 FunctionValue， 因 此 需要 在 Defaultaspx 文件 的 </form> 代 码 行 
之 前 加 入 如 下 内 容 : 


<input type="hidden" name="FunctionValue" value="" /> 


在 App_Code 中 加 入 名 为 IdentifyHelper 的 类 。 该 类 的 GetHtmlFromDataTable 方法 代码 
如 下 : 


public static string GetHtmlFromDataTable (DataTable dt) ( 
GridView gd = new GridView(); 
gd.ToolTip = dt.TableName; 
gd.Caption = dt.TableName; 
gd.DataSource - dt; 
gd.DataBind(); 
gd.Visible - true; 
gd.BorderWidth = 0; 
gd.CssClass - "list-line"; 
gd.CellPadding = 3; 
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gd.CellSpacing = 1; 

gd.HeaderStyle.CssClass = "barbg"; 

gd.HeaderStyle.HorizontalAlign - HorizontalAlign.Center; 
gd.RowStyle.CssClass - "listbg"; 


string returnString = string.Empty; 

using (System.IO.StringWriter sw = new System.IO.StringWriter()) ( 
HtmlTextWriter htw = new HtmlTextWriter (sw); 
gd.RenderControl (htw) ; 
htw.Flush(); 
string tempStr - sw.ToString(); 
returnString += tempStr; 

) 

return returnString; 


) 

上 述 代码 首先 利用 GridView 将 数据 表 的 内 容 显示 到 表格 中 ， 其 中 list-line、barbg 与 listbg 是 为 
了 美观 而 应 用 的 样式 。 然 后 利用 Html TextWriter 类 将 表格 的 内 容 转换 为 HTML 文本 格式 的 字符 串 。 

IdentifyHelper 类 的 AddJavaScriptCallback 方法 代码 如 下 : 


public static void AddJavaScriptCallback(Map map, string executeString) 
t 
object[] oa = new object[1]; 
oa[0] = executeString; 
CallbackResult cr = new CallbackResult (null, null, "javascript", oa); 
map.CallbackResults.Add(cr); 
) 
这 段 代 码 最 关键 的 类 是 CallbackResult, 它 简化 了 Web ADF 中 客户 端 回调 的 处 理 , 不 用 再 创建 
自己 的 客户 端 和 服务 器 端 逻辑 ， 使 用 CallbackResult 就 可 以 将 信息 传 回 客户 端 ， 更 新 客户 端 页 面 的 
内 容 、 图 片 或 执行 JavaScript 脚本 。 
看 到 这 , 读者 可 能 仍然 不 明白 为 什么 只 需要 通过 上 述 代码 ,而 不 需要 在 客户 端 写 代 码 ， 客 户 端 
就 会 执行 我 们 在 IdentifyPoint 类 ServerAction 方法 中 编写 的 JavaScript 代码 。 原 因 是 Web ADF 已 经 
写 好 了 客户 端 代码 。 所 有 工具 按钮 执行 完 服务 器 端 代 码 后 ， 客 户 端 执 行 C:\Inetpub\wwwroot\aspnet 
. clienESRTWebADFavaScript display dotnetadfjs 文件 中 的 processCallbackResult 方法 , 该 方法 中 
有 如 下 一 段 代码 : 
else if (action=="javascript") { 
validResponse = true; 
eval(actions[3]); 
) 
该 段 代 码 判断 如 果 服 务 器 段 的 CallbackResult 构造 函数 中 第 三 个 参数 的 内 容 是 “javascript”， 
则 执行 第 四 个 参数 指定 的 代码 。 
当然 在 构造 CallbackResult 类 的 实例 时 ,第 三 个 参数 除了 为 javascript 外 ,还 可 以 为 content、 
innercontent 与 image， 各 自 含 义 可 参考 如 下 代码 : 


if (action--"content") ( 
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validResponse - true; 
o = document.getElementById (actions[1]); 
if (o 1= mull) t 

o.outerHTML=actions [3]; 


} 
else if (action=="innercontent") { 
validResponse = true; 
o = document.getElementById (actions[1]); 
if (o = mūli) { 
o.innerHTML=actions [3]; 


} 
else if (action=="image") { 
validResponse = true; 
o = document.images[actions[1]]; 
if (o !2- null) ( 
o.src = actions[3]; 


) 
else alert (actions[1] * " was null"); 
) 
else if (action--"javascript") ( 
validResponse - true; 
eval(actions[3]); 
) 
else if(response.length»0) ( 
alert (response + "XnContext: " + context); 
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} 
最 后 要 完成 的 是 利用 网 页 将 FunctionValue 文本 框 中 的 内 容 显 示 出 来 。 在 工程 中 加 入 一 个 
HTML 文件 ， 命 名 为 IdentifyResult.htm。 其 代码 很 简单 ， 如 下 所 示 : 


<head> 
<title> 图 形 查询 结果 </title> 
<link href="css/stylel.css" type="text/css" rel="stylesheet"/> 
<script type="text/javascript" language="javascript"> 
function loadResult() { 
var identifyResult = opener.document.forms[0].FunctionValue.Value; 
var o = document.getElementById ("datadiv"); 
if (o != null) { 
o.innerHTML-identifyResult; 


) 
</script> 
</head> 
<body> 
<div runat="server" id="datadiv"> 
</div> 
</body> 
</html> 
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<script type-"text/javascript" language-"javascript"» 
function window.onload() ( 
loadResult(); 


window.focus(); 
) 
</script> 
至 此 我 们 就 完成 了 点 查询 要 素 并 显示 其 属性 。 运 行 应 用 程序 ,选择 点 查询 ， 然 后 在 地 图 上 单 击 
某 个 行政 区 划 ， 系 统 就 会 弹出 一 个 页 面 显示 该 行政 区 划 的 相关 属性 ， 例 如 图 4.23 显示 的 是 加 拿 大 
萨 斯 咯 彻 温 省 的 面积 、 人 口 等 属性 。 
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图 4.23 ”应 用 程序 运行 结果 
44.3 高 亮 显示 要 素 


在 利用 图 形 查 询 属性 时 , 用 户 通 常 希望 能 同时 看 到 有 哪些 要 素 被 选择 了 。 这 个 需求 可 以 通过 高 
亮 显示 要 素来 满足 。 

在 4.4.2 节 中 ， 我 们 已 经 查询 出 被 选择 的 要 素 ， 下 面 要 完成 的 就 是 给 这 些 要 素 用 另 一 种 方式 画 
出 来 。 

在 IdentifyHelper 类 中 ， 加 入 如 下 所 示 的 静态 方法 : 

public static void HighLightShow (Map map, DataTableCollection dtc) 

{ 

} 

高 亮 显示 要 素 一 般 可 以 通过 两 种 方式 实 。 一 是 在 地 图 资源 管理 器 中 增加 一 GraphicsLayer， 然 
后 在 该 图 层 中 将 要 素 重 新 画 一 次 ， 另 一 种 方式 是 设置 资源 绘图 功能 的 MapDescription 属性 的 
CustomGraphics 属性 。 我 们 在 该 节 中 介绍 第 二 种 方式 。 

当 使 用 ArcGIS Server 绘图 功能 时 ，MapDescription 属性 提供 了 一 个 值 对 象 ， 通 过 该 对 象 可 以 
修改 由 ArcGIS Server 地 图 服务 生成 的 地 图 的 显示 与 内 容 。 
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在 HighLightShow 方法 中 首先 要 得 到 的 当然 是 NorthAmericaMap 资源 的 绘图 功能 ， 使 用 的 代 
码 如 下 : 


MapFunctionality mf = 
(MapFunctionality)map.GetFunctionality ("NorthAmericaMap"); 


过 绘图 功能 的 MapDescription 属性 来 访问 MapDescription 对 象 ， 代 码 如 下 : 
MapDescription mapDescription = mf.MapDescription; 
然后 需要 将 原来 高 亮 显 示 的 要 素 去 掉 高 亮 ， 将 CustomGraphics 设置 为 null 即 可 ， 代 码 如 下 : 
mapDescription.CustomGraphics = null; 


由 于 MapDescription 类 属于 ESRLArcGIS.ADF.ArcGlISServer 程序 集 ， 此 外 还 有 其 他 对 象 需要 利用 
ESRIArcGIS.ADF.Web.DataSources.ArcGISServer 程序 集 ， 因 此 需要 加 入 如 下 引用 命名 空间 的 代码 : 

using ESRI.ArcGIS.ADF.ArcGISServer; 

using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 

此 时 编译 代码 则 会 报告 AreGISServer 命名 空间 不 存在 ， 原 因 是 我 们 没有 在 工程 中 加 入 上 述 两 
个 程序 集 的 引用 。 利 用 工程 的 右键 菜单 的 Add ArcGIS Reference 命令 ， 打 开 如 图 4.24 所 示 的 对 话 
框 。 在 该 对 话 框 中 分 别 选择 ESRLArcGIS.ADF.ArcGISServer 与 ESRIArcGIS.ADF.Web.DataSources. 
ArcGISServerc 程序 集 ， 并 用 Add 按钮 加 入 到 Selected Assemblies 中 。 加 入 完成 后 ， 选 择 Finish 按 
钮 关闭 对 话 框 。 这 时 再 编译 程序 则 不 会 再 有 错误 。 
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图 4.24 Add ArcGIS Reference 对 话 框 


在 清除 了 原 高 亮 显示 的 要 素 后 ， 要 绘制 新 选择 的 要 素 。 绘 制 要 素 则 必须 要 有 符号 ， 为 了 
HighLightShow 方法 看 起 来 比较 明了 与 简单 ， 我 们 利用 另 一 个 静态 方法 创建 一 个 符号 ， 代 码 如 下 : 

public static SimpleFillSymbol CreateSimpleFillSymbol() 

q 


ESRI.ArcGIS.ADF.ArcGISServer.RgbColor rgb; 
rgb = new ESRI.ArcGIS.ADF.ArcGISServer.RgbColor(); 


第 4 章 简单 Web GIS 应 用 开发 4 < 


rgb.Red = 255; 

rgb.Green = 0; 

rgb.Blue — 0; 

rgb.AlphaValue - 255; 

SimpleLineSymbol lineSym = new SimpleLineSymbol(); 
lineSym.Color - rgb; 

lineSym.Width - 1.0; 

lineSym.Style = esriSimpleLineStyle.esriSLSSolid; 
SimpleFillSymbol sfs; 

sfs = new SimpleFillSymbol(); 

sfs.Style - esriSimpleFillStyle.esriSFSForwardDiagonal; 
sfs.Color - rgb; 

sfs.Outline = lineSym; 


I 


return sfs; 


i 
上 述 代 码 创建 的 是 用 红色 和 斜 线 填充 、 红 色 边 线 的 面 符号 。SimpleFillSymbo1l 类 表示 的 是 一 


个 简单 填充 面 符 号 。Style 属性 指定 的 是 其 填充 方式 ， 我 们 使 用 的 是 esriSFSForwardDiagonal， 表 示 
斜 线 填充 ，Color 属性 表示 填充 的 颜色 ，Outline 属性 表示 边线 的 线 符号 。 


回 到 HighLightShow 方法 中 ， 加 入 如 下 语句 ， 调 用 上 面 的 方法 创建 面 符号 : 
SimpleFillSymbol sfs = CreateSimpleFillSymbol(); 
下 面 要 实现 的 就 是 需要 利用 该 符号 绘制 每 个 选中 要 素 ， 代 码 如 下 : 


foreach(DataTable dt in dtc) 


t 
if (dt.Rows.Count -- 0) 
continue; 
HighLightPolygon (mapDescription, dt, sfs); 
) 


在 上 述 代码 中 ,我 们 通过 调用 HighLightPolygon 方法 来 实现 真正 的 绘制 工作 。 该 方法 的 代码 如 下 : 


public static void HighLightPolygon (MapDescription mapDescription, 
DataTable datatable, SimpleFillSymbol sfs) 
t 


int hasCount - 0; 
if (mapDescription.CustomGraphics !- null) 

hasCount = mapDescription.CustomGraphics.Length; 
ESRI.ArcGIS.ADF.ArcGISServer.GraphicElement[] ges; 
ges = new GraphicElement[hasCount + datatable.Rows.Count]; 
CopyCustomGraphics (ges, mapDescription); 


int geoIndex = GeometryFieldIndex (datatable); 
for (int i = 0; i < datatable.Rows.Count; i++) 
{ 
ESRI.ArcGIS.ADF.Web.Geometry.Polygon polygon = 
datatable.Rows[i][geoIndex] 
as ESRI.ArcGIS.ADF.Web.Geometry.Polygon; 
PolygonN ags map polyn; 
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ags map polyn = ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer. 


Converter.FromAdfPolygon (polygon); 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement polyelement; 
polyelement = new ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement (); 


polyelement.Symbol = sfs; 
polyelement.Polygon = ags map polyn; 
ges[hasCount * i] - polyelement; 


) 


mapDescription.CustomGraphics - ges; 


j 
在 上 面 代码 的 第 一 段 中 , 由 于 我 们 选择 的 要 素 可 能 同时 位 于 几 个 图 层 中, A 


此 需要 保留 上 次 调 


用 HighLightPolygon 方法 设置 的 CustomGraphics 对 象 。 然 而 由 于 该 对 象 是 一 个 数组 ， 而 不 是 一 个 


Array 对 象 , 无 法 往 该 对 象 中 加 入 新 的 要 素 , 因此 新 增 一 个 CopyCustomGraphics 
内 容 复 制 到 临时 变量 ges 中 ， 该 方法 的 代码 如 下 : 


public static void CopyCustomGraphics (GraphicElement[] ges, 
MapDescription mapDescription) 
{ 

if (mapDescription.CustomGraphics != null) 


{ 


方法 将 该 对 象 中 的 


for (int i = 0; i < mapDescription.CustomGraphics.Length; i++) 


ges[i] = mapDescription.CustomGraphics[i]; 


) 


在 HighLightPolygon 方法 代码 的 第 二 段 中 , 首先 调用 GeometryFieldIndex 方法 得 到 几何 图 形 对 


象 在 数据 表 中 字段 的 序号 ， 其 代码 如 下 : 


public static int GeometryFieldIndex(DataTable datatable) 
d 
int geoIndex - -1; 
for (int i = 0; i < datatable.Columns.Count; i++) 
{ 
if (datatable.Columns[i].DataType == 
typeof (ESRI.ArcGIS.ADF.Web.Geometry.Geometry)) 
{ 
// 找到 Geometry 字段 的 序号 
geoIndex = i; 
break; 


) 


return geoIndex; 


) 


然后 通过 一 个 循环 ， 将 数据 表 中 的 几何 图 形 对 象 符号 化 为 Polyelement 对 象 ， 并 加 入 到 ges Zi 
组 中 。 在 该 代码 中 ， 利 用 datatable.Rows[i][geoIndex] 得 到 几何 图 形 对 象 ， 然 后 利用 Converter 类 的 
FromAdfPolygon 方法 将 其 转换 为 ESRIArcGIS.ADF.ArcGISServer PolygonN 类 型 (关于 Converter 
类 的 详细 说 明 请 参考 1.7 节 ) 。 最 后 将 该 PolygonN 设置 到 PolygonElement 对 象 的 Polygon 属性 。 
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这 里 稍微 解释 一 下 为 什么 需要 Converter 类 进行 转换 。 这 是 由 于 我 们 使 用 了 MapDescription 
值 对 象 ， 因 此 也 需要 使 用 几何 图 形 的 值 对 象 。 

在 HighLightPolygon 方法 代码 的 第 三 段 中 ,将 临时 变量 的 值 赋予 CustomGraphics， 完 成 高 亮 显示 。 

再 次 回 到 HighLightShow 方法 中 ， 加 入 如 下 语句 ， 刷 新 地 图 : 


RefreshMap (map, "NorthAmericaMap"); 


RefreshMap 方法 的 代码 如 下 : 


public static void RefreshMap(Map map, string resourceName) 


{ 


if (map.ImageBlendingMode == ImageBlendingMode.WebTier) 
{ 
map.Refresh(); 
) 
else if (map.ImageBlendingMode -- ImageBlendingMode.Browser) 
{ 
map.RefreshResource (resourceName); 
) 
H 


在 该 方法 中 首先 判断 地 图 对 象 的 ImageBlendingMode (地 图 图 片 融 合 方式 ) 属性 ， 如 果 该 值 为 
WebTier， 则 刷新 整个 地 图 ， 否 则 只 刷新 指定 的 资源 。 

这 里 简要 介绍 一 下 地 图 图 片 的 融合 方 成 。 

ArcGIS Server 提供 了 两 种 图 形 处 理 方式 ， 一 种 称 为 浏览 器 端 融 合 (Browser Blending) , 5j— 
种 成 为 Web 层 融 合 (Web-tier Blending) . 

浏览 器 端 融合 的 原理 如 图 4.25 所 示 。 在 该 种 方式 下 ， 来 自 不 同 GIS 服务 器 的 图 片 ， 不 经 过 Web 
应 用 程序 ， 直 接 发 送 给 用 户 ， 在 用 户 的 浏览 器 端 利用 浏览 器 应 用 程序 本 身 的 功能 融合 为 一 张 图 片 。 


Browser Blending 


a=] GIS Server 1 
Web 
Application 


GIS Server 2 
图 4.25 浏览 器 端 融合 过 程 


Web 层 融 合 的 原理 如 图 4.26 所 示 。 在 该 种 方式 下 , 来 自 不 同 GIS 服务 器 的 图 片 在 Web 服务 器 
上 由 Web 应 用 程序 进行 融合 ， 然 后 将 结果 发 送 到 客户 端的 浏览 器 ， 进 行 显示 。 


Web-tier Blending 


aa 
GIS Server 1 


Web 
Application 
GIS Server 2 


图 426 Web 层 融 合 过 程 
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完成 HighLightShow 方法 后 ， 切 换 到 rdentifyHelper 类 的 ShowIdentifyResult 方法 中 ， 增 
加 对 HighLightShow 方法 的 调用 ，ShowIdentifyResult 方法 完整 的 代码 如 下 : 


public static void ShowIdentifyResult (Map map, DataTableCollection dtc) 


t 


string returnstring - string.Empty; 
foreach (DataTable dt in dtc) 


{ 


if (dt.Rows.Count == 0) 
continue; 
returnstring += GetHtmlFromDataTable (dt); 


HighLightShow 


returnstring 

returnstring 

string functi 

functionValue 

functionValue 

AddJavaScript 
} 


AE] http://1ocdh 


(map, dtc); 


= returnstring.Replace ("\r\n", ""); 
= returnstring.Replace("Mn", ""); 
onValue = "var theForm = document.forms[0];"; 
+= "theForm.FunctionValue.Value-'" + returnstring + "';"; 
+= "open('IdentifyResult.htm', 'IdentifyResult');"; 
Callback(map, functionValue); 


运行 程序 ， 运 行 效果 如 图 427 所 示 。 
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44.4 自 定义 矩形 查询 工具 


前 面 我 们 将 点 查询 了 


[有 具 的 实现 代码 分 割 成 很 小 粒度 的 方法 , 为 实现 其 他 图 形 查 询 数据 工具 提供 
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了 很 好 的 基础 ， 使 得 加 入 其 他 工具 也 变 得 非常 简单 。 


要 加 入 和 矩形 查询 工具 ， 首 先 需 要 在 Defaultaspx 页 面 的 工具 栏 控件 的 <esri:ToolbarItems > 与 
</esri:ToolbarItems > 代码 段 之 间 再 增加 如 下 代码 : 


<esri:Tool ClientAction-"DragRectangle" Name-"RectIdentify" 
DefaultlImage-"-/Images/Toolbar/select rect 1.jpg" 
HoverlImage-"-/Images/Toolbar/select rect 2.jpg" 
SelectedlImage-"-/Images/Toolbar/select rect 3.jpg" 
ServerActionAssembly-"App Code" 
ServerActionClass-"IdentifyRectangle" 
Text-"RectlIdentify" 
ToolTip-"ApJÉfri" /> 


在 上 述 代码 中 我 们 指定 服务 器 端 实现 该 矩形 查询 工具 的 类 为 App Code 文件 夹 下面 的 
IdentifyRectangle 类 。 

在 App Code 文件 夹 下 增加 IdentifyRectangle 类 ， 该 类 的 实现 代码 如 下 : 

using ESRI.ArcGIS.ADF.Web.Geometry; 


using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools; 


public class IdentifyRectangle : IMapServerToolAction ( 
#region IServerAction Members 


void IMapServerToolAction.ServerAction(ToolEventArgs args) ( 
Map mapCtrl = args.Control as Map; 
RectangleEventArgs rectargs - (RectangleEventArgs)args; 
System.Drawing.Rectangle myrect = rectargs.ScreenExtent; 


Point minpnt = Point.ToMapPoint( 
myrect.Left, myrect.Bottom, mapCtrl.Extent, 
(int)mapCtrl.Width.Value, (int)mapCtrl.Height.Value); 
Point maxpnt = Point.ToMapPoint( 
myrect.Right, myrect.Top, mapCtrl.Extent, 
(int)mapCtrl.Width.Value, (int)mapCtrl.Height.Value); 
Envelope mapPoly = new Envelope (minpnt, maxpnt); 


IdentifyHelper.Identify (mapCtrl, mapPoly); 
) 


#endregion 

} 

上 述 代码 中 指定 IdentifyRectangle 类 实现 IMapServerToolAction 接口 , 这 是 工具 类 所 必须 的 。 

在 IMapServerToolAction.ServerAction 方法 中 通过 参数 args 得 到 用 户 在 地 图 上 拖 动 的 矩形 的 屏 
幕 坐标 范围 ， 由 于 Web ADF 没有 提供 矩形 从 屏幕 坐标 转换 为 地 图 坐标 的 方法 ， 因 此 上 述 代码 利用 
和 矩形 的 对 角 的 两 个 点 分 别 转换 到 地 图 坐标 ， 然 后 利用 Envelope 类 的 构造 函数 构造 一 个 地 图 坐标 
的 矩形 对 象 。 最 后 调用 IdentifyHelper 类 的 Identify 方法 实现 查询 。 

在 IdentifyHelper 类 中 加 入 如 下 代码 : 
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public static void Identify (Map map, 

ESRI.ArcGIS.ADF.Web.Geometry.Geometry mapGeometry) 

í 

} 

我 们 将 利用 该 方法 实现 矩形 以 及 多 边 形 、 线 查询 ， 因 此 方法 的 第 二 个 参数 写成 这 些 类 的 父 类 
Geometry, 达到 代码 重用 的 目的 。 当 然 我 们 也 可 以 利用 4.4.2 节 中 介绍 的 查询 功能 的 Identify 方法 
来 实现 ， 这 里 另 写 一 个 方法 的 目的 只 是 为 了 向 读者 介绍 不 同 的 实现 途径 。 

与 点 查询 一 样 ， 在 调用 查询 功能 之 前 一 定 要 判断 资源 是 否 具有 查询 功能 ， 代 码 如 下 : 

IGISFunctionality gisfunc = map.GetFunctionality ("NorthAmericaMap"); 


if (gisfunc == null) 
return; 


IGISResource gisresource - gisfunc.Resource; 
bool supportquery = 
gisresource.SupportsFunctionality (typeof (IQueryFunctionality)); 
if (!supportquery) 

return; 


如 果 具 有 查询 功能 ， 则 利用 如 下 代码 得 到 该 查询 功能 : 


IQueryFunctionality qfunc; 
qfunc = gisresource.CreateFunctionality (typeof (IQueryFunctionality), null) as 
IQueryFunctionality; 


只 能 对 可 查询 图 层 进行 空间 查询 ， 因 此 在 执行 空间 查询 之 前 ， 需 要 得 到 可 查询 图 层 数组 ， 代 码 如 下 : 


string[] lIDs, lNames; 
qfunc.GetQueryableLayers (null, out lIDs, out lNames); 


接着 依据 传 入 的 几何 图 形 对 象 ， 构 造 一 个 空间 查询 对 象 ， 代 码 如 下 : 


ESRI.ArcGIS.ADF.Web.SpatialFilter spatialfilter = 
new ESRI.ArcGIS.ADF.Web.SpatialFilter(); 
spatialfilter.ReturnADFGeometries = false; 
spatialfilter.MaxRecords = 1000; 
spatialfilter.Geometry = mapGeometry; 


在 上 述 代码 中 我 们 指定 查询 最 多 返回 1000 条 记录 ， 查 询 图 形 为 传 入 的 参数 。 此 外 还 可 以 通过 
指定 SpatialFilter 类 的 WhereClause 属性 执行 属性 查询 。 
然后 通过 一 个 对 可 查询 图 层 循环 调用 查询 功能 的 Query 方法 ， 查 询 每 个 图 层 ， 代 码 如 下 : 


System.Data.DataSet dataset = new System.Data.DataSet(); 
for (int i = 0; < lIDs.Length; i**) ( 
System.Data.DataTable datatable = gfunc.Query( 
null, lIDs[i], spatialfilter); 
if (datatable == null) 
continue; 
datatable.TableName - lNames[i]; 
dataset.Tables.Add(datatable); 
} 


至 此 完成 了 图 形 查 询 要 素 工作 ， 余 下 的 是 将 查询 到 的 要 素 的 属性 显示 出 来 并 高 亮 显示 这 些 要 
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素 ， 该 功能 已 经 在 4.4.2 5 4.4.3 两 节 中 实现 ， 直 接 调用 即 可 。 代 码 如 下 : 


DataTableCollection dtc = dataset.Tables; 
ShowIdentifyResult (map, dtc); 


Identify 方法 的 完整 代码 如 下 : 


public static void Identify(Map map, 
ESRI.ArcGIS.ADF.Web.Geometry.Geometry mapGeometry) 
t 
IGISFunctionality gisfunc = map.GetFunctionality ("NorthAmericaMap"); 
if (gisfunc -- null) 
return; 


IGISResource gisresource - gisfunc.Resource; 
bool supportquery = 
gisresource.SupportsFunctionality (typeof (IQueryFunctionality)); 
if (!supportquery) 
return; 


IQueryFunctionality qfunc; 

qfunc = gisresource.CreateFunctionality( 
typeof(IQueryFunctionality), null) as IQueryFunctionality; 

string[] lIDs, lNames; 

qfunc.GetQueryableLayers (null, out lIDs, out lNames); 


ESRI.ArcGIS.ADF.Web.SpatialFilter spatialfilter = 
new ESRI.ArcGIS.ADF.Web.SpatialFilter(); 
spatialfilter.ReturnADFGeometries = false; 
spatialfilter.MaxRecords = 1000; 
spatialfilter.Geometry = mapGeometry; 


System.Data.DataSet dataset - new System.Data.DataSet(); 
for (int i = 0; i < lIDs.Length; itt) ( 
System.Data.DataTable datatable = qfunc.Query( 
null, lIDs[i], spatialfilter); 
if (datatable -- null) 
continue; 
datatable.TableName = lNames[i]: 
dataset.Tables.Add (datatable); 


DataTableCollection dtc = dataset.Tables; 
ShowIdentifyResult (map, dtc); 
) 


编译 并 运行 程序 ， 查 询 效果 如 图 428 所 示 。 
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图 428 逢 形 查 询 效果 
4.4.5” 自 定义 多 边 形 查询 工具 


在 Defaultaspx 页 面 的 工具 栏 控件 的 <esri:ToolbarItems > 与 </esri:ToolbarItems > 代码 段 之 间 再 
增加 如 下 代码 ， 用 于 在 工具 栏 上 增加 多 边 形 查 询 工 具 按 钮 : 


<esri:Tool ClientAction="Polygon" Name="PolygonIdentify" 
DefaultImage="~/Images/Toolbar/select polygon 1.jpg" 
HoverImage="~/Images/Toolbar/select polygon 2.jpg" 
SelectedImage="~/Images/Toolbar/select polygon 3.jpg" 
ServerActionAssembly-"App Code" 
ServerActionClass-"IdentifyPolygon" 
Text-"PolygonIdentify" ToolTip=" 多 边 形 查询 " /> 


在 App Code 文件 夹 下 增加 IdentifyPolygon 类 ， 该 类 的 实现 代码 如 下 : 


using ESRI.ArcGIS.ADF.Web.Geometry; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools; 


public class IdentifyPolygon : IMapServerToolAction ( 
#region IMapServerToolAction Members 


void IMapServerToolAction.ServerAction(ToolEventArgs args) ( 
Map map = args.Control as Map; 
PolygonEventArgs polyArgs = (PolygonEventArgs)args; 
Polygon mapPoly = GeometryHelper.GetMapPolygon (map, polyArgs); 
IdentifyHelper.Identify (map, mapPoly); 


#endregion 
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在 上 述 代 码 中 我 们 先 通 过 GeometryHelper 类 的 静态 GetMapPolygon 方法 将 屏幕 坐标 的 多 边 形 
转换 为 地 图 坐标 的 多 边 形 ， 然 后 直接 调用 在 4.4.4 节 中 实现 的 几何 图 形 查 询 方法 ， 即 完成 多 边 形 查询 。 
在 App_Code 文 件 夹 下 增加 GeometryHelper 类 , 先 在 该 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web.Geometry; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls; 


然后 加 入 如 下 代码 ， 实 现 多 边 形 坐 标 系统 的 转换 : 


public static ESRI.ArcGIS.ADF.Web.Geometry.Polygon GetMapPolygon (Map map, 
PolygonEventArgs polyArgs) 
{ 


System.Drawing.Point[] screenpoly = polyArgs.Vectors; 


PointCollection pc - new ESRI.ArcGIS.ADF.Web.Geometry.PointCollection(); 
foreach (System.Drawing.Point dpnt in screenpoly) ( 
pc.Add(Point.ToMapPoint (dpnt, map.Extent, 
(int)map.Width.Value, (int)map.Height.Value)); 
) 


Ring ring - new Ring(); 

ring.Points = pc; 

RingCollection rings - new RingCollection(); 
rings.Add (ring); 

Polygon mapPoly = new Polygon(); 
mapPoly.Rings - rings; 

return mapPoly; 


) 
编译 并 运行 程序 ， 利 用 多 边 形 查 询 工具 查询 地 物 要 素 ， 效 果 如 图 429 所 示 。 
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446 ” 自 定义 圆 查询 工具 


在 Default.aspx 页 面 的 工具 栏 控件 的 <esri:ToolbarItems> 与 </esri:ToolbarItems> 代 码 段 之 间 再 增 
加 如 下 代码 ， 用 于 在 工具 栏 上 增加 圆 查询 工具 按钮 : 


Xesri:Tool ClientAction-"Circle" Name-"CircleIdentify" 
DefaultImage-"-/Images/Toolbar/select circle 1.jpg" 
HoverlImage-"-/Images/Toolbar/select circle 2.jpg" 
SelectedlImage-"-/Images/Toolbar/select circle 3.jpg" 
ServerActionAssembly-"App Code" 
ServerActionClass-"IdentifyCircle" 
Text-"CircleIdentify" ToolTip=" 圆 查询 " /> 


在 App Code 文件 夹 下 增加 IdentifyRectangle 类 ， 该 类 的 实现 代码 如 下 : 


using ESRI.ArcGIS.ADF.Web.Geometry; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools; 


public class IdentifyCircle : IMapServerToolAction ( 
#region IMapServerToolAction Members 


void IMapServerToolAction.ServerAction(ToolEventArgs args) { 
Map map = args.Control as Map; 
CircleEventArgs circleArgs - (CircleEventArgs)args; 
Polygon mapPoly = GeometryHelper.GetMapPolygon (map, circleArgs); 
IdentifyHelper.Identify (map, mapPoly); 
i 


#endregion 


} 


在 44.4 节 中 编写 的 IdentifyBelper 类 的 Identify 方法 可 实现 几何 图 形 的 查询 ， 我 们 只 需 
直接 调用 即 可 。 不 过 由 于 在 ESRLArcGIS.ADF.Web.Geometry.Geometry 类 的 子 类 中 并 没有 一 个 表示 
圆 的 类 ， 因 此 在 调用 Identify 方法 之 前 ， 先 利用 GeometryHelper 类 的 GetMapPolygon 方法 , 将 
一 个 多 边 形 近 似 表示 一 个 圆 转 换 。 

GeometryHelper 类 的 GetMapPolygon 方法 代码 如 下 : 


public static ESRI.ArcGIS.ADF.Web.Geometry.Polygon GetMapPolygon( 
Map map, CircleEventArgs circleArgs) ( 

System.Drawing.Point screenPointCenter = new System.Drawing.Point( 
(int)circleArgs.CenterPoint.X, 
(int)circleArgs.CenterPoint.Y); 

System.Drawing.Point screenPointBrink = new System.Drawing.Point( 
(int)circleArgs.CenterPoint.X, 
(int)circleArgs.CenterPoint.Y * (int)circleArgs.Radius); 


// 得 到 地 图 坐标 中 的 半径 

Point mapPointCenter = Point.ToMapPoint (screenPointCenter, map.Extent, 
(int)map.Width.Value, (int)map.Height.Value); 

Point mapPointBrink = Point.ToMapPoint (screenPointBrink, map.Extent, 


) 


编 
地 图 上 
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(int)map.Width.Value, (int)map.Height.Value); 
double radius - Math.Sqrt( 

(mapPointCenter.X - mapPointBrink.X) * 

(mapPointCenter.X - mapPointBrink.X) + 

(mapPointCenter.Y- mapPointBrink.Y) * 

(mapPointCenter.Y - mapPointBrink.Y)); 


GraphicsPath gpath = new GraphicsPath(); 
gpath.AddEllipse((float) (mapPointCenter.X - radius), 
(float) (mapPointCenter.Y - radius), 
(float) (2 * radius), (float) (2 * radius)); 
Matrix translateMatrix = new Matrix(); 
translateMatrix.Translate(0, 0); 


float flattening - (float) (radius / 1000); 
gpath.Flatten(translateMatrix, flattening); 


PointCollection pc = new PointCollection(); 

foreach (System.Drawing.PointF dpnt in gpath.PathPoints) ( 
pc.Add(new ESRI.ArcGIS.ADF.Web.Geometry.Point(dpnt.X, dpnt.Y)); 

) 


Ring ring - new Ring(); 

ring.Points = pc; 

RingCollection rings - new RingCollection(); 
rings.Add (ring); 

Polygon mapPoly - new Polygon(); 
mapPoly.Rings - rings; 

return mapPoly; 


译 并 运行 程序 ， 选 择 圆 查询 工具 ， 然 后 在 地 图 上 单 击 一 点 ， 然 后 移动 鼠标 ， 即 可 看 到 系统 在 
绘制 圆 ， 再 次 单 击 鼠 标 ， 选 定 圆 的 半径 ， 完 成 圆 查询 。 操 作 过 程 效果 如 图 4.30 所 示 。 
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4.4.7” 自 定义 命令 


前 面 几 小 节 介 绍 了 如 何 自 定义 工具 , 本 小 节 介绍 如 何 实 现 自 定义 命令 。 有 时 用 户 希 望 清除 那些 
高 亮 显 示 的 查询 ， 通 过 一 个 命令 就 可 实现 。 

同 工 具 一 样 ， 首 先 需要 在 工具 栏 中 增加 一 个 按钮 ， 只 是 该 按钮 的 类 型 是 命令 。 可 直接 在 
<esri:ToolbarItems> 与 </esri:ToolbarItems> 代码 段 之 间 增 加 如 下 代码 ， 在 工具 栏 中 增加 名 为 
ClearSelection 的 命令 按钮 : 


Xesri:Command ClientAction-"" Name-"ClearSelection" 
DefaultImage-"-/Images/Toolbar/clearhighlight 1.jpg" 
HoverImage-"-/Images/Toolbar/clearhighlight 2.jpg" 
SelectedImage-"-/Images/Toolbar/clearhighlight 3.jpg" 
ServerActionAssembly-"App Code" 
ServerActionClass-"ClearSelection" 

Text=" 清 除 选 择 " ToolTip=" 清 除 选 择 " JavaScriptFile-"" /> 


命令 也 需要 在 服务 器 端 有 一 个 类 执行 相关 操作 。 与 工具 不 同 的 是 ， 该 类 需要 实现 的 是 
IMapServerCommandAction 接口 ， 而 不 是 IMapServerToolAction 接口 。 


在 App Code 文件 夹 下 增加 名 为 ClearSelection 的 类 ， 该 类 的 实现 代码 如 下 : 


using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools; 
using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 


/// «summary» 

/// 清除 高 亮度 显示 要 素 命令 

/// «/summary» 

public class ClearSelection : IMapServerCommandAction 
il 


#region IServerAction Members 


void IServerRction.ServerRAction (ToolbarItemInfo info) 

t 
Map map = info.BuddyControls[0] as Map; 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality mf; 
mf = map.GetFunctionality("NorthAmericaMap") as MapFunctionality; 
MapDescription mapDescription = mf.MapDescription; 


if (mapDescription.CustomGraphics == null) 
return; 

if (mapDescription.CustomGraphics.Length == 0) 
return; 


mapDescription.CustomGraphics = null; 
IdentifyHelper.RefreshMap (map, "NorthAmericaMap"); 


#endregion 
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代码 很 简单 ， 首 先 通 过 地 图 对 象 的 GetFunctionality 方法 得 到 NorthAmericaMap 资源 的 绘图 功 
能 ， 然 后 将 绘图 功能 的 MapDescription 属性 的 CustomGraphics 属性 设置 为 null， 即 可 清除 高 亮 显 
示 要 素 ， 最 后 调用 IdentifyHelper 类 的 静态 方法 RefreshMap 刷新 地 图 ， 使 客户 端 看 到 地 图 变 
化 。 


4.5 用 属性 查询 图 形 


地 理 信息 系统 最 常用 的 功能 是 通过 图 形 查 询 属 性 以 及 通过 属性 查询 图 形 , 在 4.4 节 中 介绍 的 方 
法 都 属于 通过 几何 图 形 来 查询 属性 ， 本 节 将 通过 一 个 实例 来 介绍 如 何 通过 属性 来 查询 图 形 。 

本 节 实 例 要 实现 的 是 用 户 在 文本 框 中 输入 条 件 , 然后 高 亮 显示 满足 该 条 件 的 图 形 。 查 询 可 以 针 
对 任何 指定 的 图 层 ， 查 询 条 件 的 字段 可 以 是 图 层 中 的 任 一 字段 。 

按照 4.1.3 节 介绍 的 方法 创建 一 个 直接 使 用 Web 控件 的 Web 应 用 程序 ,命名 为 AttributeQuery， 
地 图 资源 管理 器 、 地 图 、Toc、 工 具 栏 控件 的 设置 都 同 4.1.3 小 节 的 FromControl。 


4.5.1 资源 内 容 查询 


为 了 让 用 户 能 够 选择 需要 查询 的 图 层 , 需要 提供 一 个 下 拉 列 表 框 , 在 该 列表 框 中 列 出 所 有 图 层 
的 名 称 ， 以 便 用 户 选择 。 因 此 首先 要 实现 的 是 查询 当前 的 地 图 资源 中 包含 哪些 图 层 。 

首先 需要 在 Default.aspx 页 面 中 的 Tocl 控件 下 方 加 入 一 标签 控件 (Lable, 在 工具 箱 的 Standard 
选项 卡 中 ) Labell ， 将 其 Text 属性 设置 为 “查询 图 层 : ”。 

注意 , 需要 通过 右键 菜单 的 Style 命令 将 position 设置 为 absolute, 才能 将 控件 拖 到 指定 的 位 置 。 
当然 也 可 以 通过 直接 修改 页 面 代 码 实 现 。 

然后 在 Labell 控件 的 下 方 ， 加 入 一 个 Div 控件 〈 在 工具 箱 的 HTML 选项 卡 中 ) ， 将 ID 设置 
为 layerListDiv。 我 们 将 在 该 Div 中 用 代码 插入 一 个 下 拉 列 表 框 ， 显 示 所 有 图 层 名 称 。 

为 了 实现 部 分 页 面 刷新 ， 本 实例 将 充分 利用 ASP.Net 2.0 的 Callback 机 制 。 

要 实现 Callback 机 制 ，ASPNet 的 页 面 必须 实现 ICallbackEventHandler， 因 此 首先 在 
Default.aspx.cs 文件 中 ， 修 改 Default 类 的 声明 为 如 下 代码 : 


public partial class Default : System.Web.UI.Page, ICallbackEventHandler 


由 于 我 们 希望 程序 运行 后 立即 显示 所 有 图 层 名 称 ， 所 以 需要 页 面 加 载 时 执行 查询 。 因 此 在 
Default.aspx 页 面 代码 的 最 后 加 入 如 下 代码 : 


<script type="text/javascript" language="javascript"> 
function window.onload() 
t 
GetResourceContent () ; 
) 


</script> 


该 JavaScript 代码 表示 当 页 面 加 载 时 执行 GetResourceContent 函数 。 在 页 面 的 <head> 与 </head> 
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之 间 加 入 如 下 代码 ， 实 现 GetResourceContent 函数 : 


<script language-"javascript" type-"text/javascript"» 
function GetResourceContent () 


t 


var message = 'ActiveType-GetResourceContent'; 
var context - 'Pagel'; 
«$-getResourceContentCallBack$» 


) 
</script> 


在 上 述 代码 中 ， 我 们 指定 ActiveType〈 标 识 当 前 函数 ) 为 GetResourceContent， 然 后 执行 实际 
的 回调 脚本 , 该 脚本 是 利用 GetCallbackEventReference 方法 生成 的 。 切 换 到 Default.aspx.cs 文件 中 ， 
声明 如 下 变量 : 

public string getResourceContentCallBack; 

并 在 Page Load 方法 中 增加 如 下 代码 ， 生 成 调用 的 客户 端 脚 本 : 


getResourceContentCallBack = Page.ClientScript.GetCallbackEventReference( 
this, "message", "processCallbackResult", 
"context", "postBackError", true); 


上 述 代码 表明 ， 传 入 的 参数 用 message 变量 表示 ， 上 下 文 变量 用 context 表示 ， 如 果 成 功 执行 
服务 器 端 代码 ， 返回 到 客户 端 后 执行 processCallbackResult 函数 ， 否 则 执行 postBackError 函数 。 这 
两 个 函数 都 是 Web ADF 自身 带 的 。 

下 面 要 实现 的 就 是 ICallbackEventHandler 接口 要 求 的 两 个 方法 ,定位 到 “ICallbackEventHandler 
Members” 代 码 区 域 ， 在 其 中 首先 加 入 如 下 一 用 于 保存 传 入 参数 的 字符 串 变量 : 

private string callbackArg; 

服务 器 首先 执行 的 是 RaiseCallbackEvent 方法 ， 在 该 方法 中 ， 将 传 入 参数 保存 到 类 的 字段 
callbackArg 中 ， 代 码 如 下 : 


void ICallbackEventHandler.RaiseCallbackEvent (string eventArgument) { 
callbackArg = eventArgument; 
} 


服务 器 端 接着 执行 的 是 GetCallbackResult， 真 正 实现 代码 在 该 方法 中 。 代 码 如 下 : 
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string ICallbackEventHandler.GetCallbackResult() { 


// 将 传 入 参数 依据 & 分 割 符 分 到 querystring 变量 中 
Array keyValuePairs = callbackArg.Split("&".ToCharArray()); 
NameValueCollection queryString = new NameValueCollection(); 
string[] keyValue; 
string response = 
if (keyValuePairs.Length » 0) ( 

for (int i = 0; i < keyValuePairs.Length; i++) ( 


"mn. 
; 


keyValue = 
keyValuePairs.GetValue (i).ToString().Split("-".ToCharArray()); 
queryString.Add(keyValue[0], keyValue[1]); 
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} 
else { 
keyValue = callbackArg.Split("=".ToCharArray ()); 
if (keyValue.Length > 0) 
queryString.Add(keyValue[0], keyValue[1]); 
} 


// 针对 参数 中 指定 的 ActiveType 不 同 执行 不 同 操作 
string controlType = queryString["ActiveType"]; 
string eventArg = queryString["EventArg"]; 
switch (controlType) ( 
// 获取 资源 图 层 信息 
case "GetResourceContent": 
response = GisFunctionality.GetResourceContent (Map1); 
break; 
default: 
break; 


return response; 


) 

在 上 述 代 码 中 , 我 们 首先 依据 “&” 分 割 符 , 将 传 到 服务 器 端的 参数 转换 为 NameValueCollection 
类 型 (可 通过 键 或 索引 访问 的 关联 String 键 和 String 值 的 集合 ), 然后 依据 客户 端 指定 的 不 同类 型 ， 
即 ActiveType 的 值 不 同 ， 执 行 不 同 的 操作 。 

对 于 执行 资源 图 层 信息 查询 ， 我 们 调用 的 是 GisFunctionality 类 的 GetResourceContent 
静态 方法 。 

在 App Code 路 径 中 加 入 名 为 GisFunctionality 的 类 。 在 该 类 的 头 部 加 入 如 下 命名 空间 引 
用 代码 : 

using ESRI.ArcGIS.ADF.Web.UI.WebControls; 

using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 

注意 ， 仍 然 需要 读者 按照 4.4.3 节 中 介绍 的 方法 加 入 ArcGISServer 的 引用 。 

GetResourceContent 方法 的 实现 代码 如 下 : 


public static string GetResourceContent (Map map) { 
ESRI.ArcGIS.Carto.IMapLayerInfos mapLayers = GetMapLayerInfos (map); 


System.Text.StringBuilder strBld - new System.Text.StringBuilder(); 
strBld.Append ("<select id-'LayerList' onchange-'ShowFieldInfo()'»"); 


for (int i = 0; i < mapLayers.Count; i++) ( 
ESRI.ArcGIS.Carto.IMapLayerInfo linfo = mapLayers.get Element (i) 
as ESRI.ArcGIS.Carto.IMapLayerInfo; 
strBld.Append ("<option value-V"" + linfo.ID + "V" 
strBld.Append(linfo.Name + "«/option»"); 


FF 


} 
strBld.Append ("</select>"); 


SI9 q3M 


j b Web GIS 开发 一 一 ArcGIS Server 与 .NET 


CallbackResult cr = new CallbackResult("div", "layerListDiv", 
"innercontent", strBld.ToString()); 
map.CallbackResults.Add (cr); 
return map.CallbackResults.ToString(); 
H 
在 该 方法 用 首先 调用 GetMapLayerInfos 方法 ， 得 到 地 图 图 层 信息 对 象 ， 然 后 依据 地 图 图 层 信息 
构造 一 个 字符 串 表 示 的 下 拉 列 表 框 ， 接 着 把 该 字符 串通 过 CallbackResult 类 的 构造 函数 构造 为 ID 为 
layerListDiv 的 div 控件 ， 并 将 该 CallbackResult 加 入 到 地 图 的 CallbackResults 属性 中 ， 最 后 将 该 属性 
返回 。 我 们 在 4.4.2 节 中 已 经 详细 介绍 了 CallbackResult 的 原理 ， 还 不 了 解 的 读者 可 再 回头 看 看 。 
GetMapLayerInfos 方法 的 代码 如 下 : 


private static ESRI.ArcGIS.Carto.IMapLayerInfos GetMapLayerInfos (Map map) 
{ 
MapFunctionality mf = 
(MapFunctionality)map.GetFunctionality ("NorthAmericaMap"); 
MapResourceLocal mr; 
mr = mf.MapResource as MapResourceLocal; 
ESRI.ArcGIS.Server.IServerContext context - 
mr.ServerContextInfo.ServerContext; 
ESRI.ArcGIS.Carto.IMapServer server = 
context.ServerObject as ESRI.ArcGIS.Carto.IMapServer; 
ESRI.ArcGIS.Carto.IMapServerInfo mapInfo = 
server.GetServerInfo(server.DefaultMapName); 
return (ESRI.ArcGIS.Carto.IMapLayerInfos)mapInfo.MapLayerInfos; 
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} 


在 上 述 的 代码 中 ， 首 先 利用 地 图 对 象 的 GetFunctionality 方法 得 到 NorthAmericaMap 资源 的 绘 
图 功能 ， 然 后 由 此 功能 得 到 类 型 为 MapResourceLocal 的 本 地 地 图 资源 ， 然 后 由 该 资源 得 到 地 图 服 
务 的 上 下 文 对象 ， 最 后 得 到 地 图 图 层 信 息 对 象 。 

编译 并 运行 程序 ， 结 果 如 图 4.31 所 示 。 


A Untitled Page - Microsoft Internet Explorer 
XEO Bc) EEV HEW IA "Q0 
HAED) [E] hts: //1 ccathost/AttributeQuery/De£ual t. aspx 


NorthAnereaVep 
= Flem bm 
(=i 
EI 
mu 


日 加 mexico 


图 4.31 查询 地 图 资源 的 图 层 信息 
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4.5.2 图 层 字段 信息 查询 


要 通过 属性 查询 图 形 ， 就 必须 事先 知道 图 层 中 包含 哪些 字段 。 

这 一 节 要 实现 的 就 是 当 用 户 通 过 下 列 列表 框 选择 某 图 层 时 ,将 图 层 中 的 所 有 字段 及 其 数据 类 型 
以 一 个 表格 的 方式 表现 出 来 。 首 先 需 要 在 Default.aspx 页 面 中 的 layerListDiv 控件 下 方 加 入 一 名 为 
fieldListDiv 的 Div 控件 。 然 后 切换 到 页 面 <head> 与 </head> 之 间 的 代码 ， 在 GetResourceContent PÁ 
数 下 面 加 入 如 下 函数 : 

function ShowFieldInfo() 


{ 
var o = document.getElementById ("LayerList"); 


var message = 'ActiveType-ShowFieldInfo&EventArg-'; 
message *- o.value; 
var context - 'Pagel'; 


«$-showFieldInfoCallBack$» 

} 

在 GetResourceContent 方法 中 构造 下 拉 列 表 框 控件 时 ， 指 定 当 该 控件 发 生 onchange 事件 是 调 
用 ShowFieldInfo0) 函 数 。 

在 上 述 代码 中 ， 我 们 指定 ActiveType 为 ShowFieldInfo， 并 设置 EventArg( 即 事件 参数 ) 为 当 
前 用 户 选择 的 图 层 的 ID 值 。 

切换 到 Default.aspx.cs 文件 中 ， 在 _Default 类 中 再 加 入 如 下 公用 字段 : 

public string showFieldInfoCallBack; 

然后 在 Page Load 方法 中 增加 如 下 代码 ， 生 成 调用 的 客户 端 脚本 : 


showFieldInfoCallBack = Page.ClientScript.GetCallbackEventReference (this, 
"message", "processCallbackResult", "context", "postBackError", true); 


然后 在 ICallbackEventHandler.GetCallbackResult0 方 法 的 针对 不 同 ActiveType 执行 不 同 操作 的 
switch 部 分 代码 中 加 入 如 下 语句 ， 执 行 图 层 字段 查询 : 


case "ShowFieldInfo": 


response = GisFunctionality.ShowFieldInfo(Mapl, eventArg); 
break; 


上 面 的 代码 表明 ， 真 正 实现 查询 的 是 GisFunctionality 类 的 ShowFieldInfo 静态 方法 。 
切换 到 GisFunctionality.cs 文件 中 ， 加 入 ShowFieldInfo 方法 ， 其 代码 如 下 : 


public static string ShowFieldInfo(Map map, string layerIndex)( 
ESRI.ArcGIS.Carto.IMapLayerInfos mapLayers = GetMapLayerInfos (map); 


DataColumn fieldNameColumn = new DataColumn ("字段 名 "); 
fieldNameColumn.DataType — System.Type.GetType ("System.String"); 
DataColumn fieldDataTypeColumn = new DataColumn ("字段 类 型 "); 
fieldDataTypeColumn.DataType = System.Type.GetType ("System.String"); 
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System.Data.DataTable table = new DataTable(); 
table.Columns.Add (fieldNameColumn); 
table.Columns.Add(fieldDataTypeColumn); 


for (int i = 0; i < mapLayers.Count; i++) 
{ 
ESRI.ArcGIS.Carto.IMapLayerInfo linfo = mapLayers.get Element (i); 
if (!linfo.ID.ToString().Equals (layerIndex)) 
continue; 


ESRI.ArcGIS.Geodatabase.IFields fields = linfo.Fields; 

for (int j = 0; j < fields.FieldCount; j++) 

{ 
ESRI.ArcGIS.Geodatabase.IField field = fields.get Field(j); 
string[] rowValue = new string[2]; 
rowValue[0] = field.Name; 
rowValue[1] = field.Type.ToString(); 
table.Rows.Add(rowValue); 


string returnstring - GetHtmlFromDataTable (table); 

CallbackResult cr - new CallbackResult("div", "fieldListDiv", 
"innercontent", returnstring); 

map.CallbackResults.Add(cr); 

return map.CallbackResults.ToString(); 
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} 

在 上 面 的 代码 中 ， 首 先 调用 GetMapLayerInfos 方法 得 到 图 层 信息 。 然 后 构造 了 一 个 数据 表 对 
象 ， 该 数据 表 中 包含 两 个 字段 ， 一 个 用 于 保存 图 层 字段 的 名 称 ， 另 一 个 保存 图 层 字段 的 数据 类 型 。 
然后 通过 循环 将 用 户 指定 图 层 的 字段 信息 填充 到 数据 表 中 。 接 着 调用 GetHtmlFromDataTable 方法 
依据 数据 表 构 造 一 个 表格 形式 的 HTML 字符 串 。 最 后 通过 CallbackResult 类 将 该 字符 串 表 示 表 格 填 
充 到 名 为 fieldListDiv 的 Div 控件 中 。 

GetHtmlFromDataTable 方法 的 代码 如 下 : 


public static string GetHtmlFromDataTable (DataTable dt) ( 
GridView gd - new GridView(); 
gd.ToolTip = dt.TableName; 
gd.Caption = dt.TableName; 
gd.DataSource - dt; 
gd.DataBind(); 
gd.Visible = true; 
gd.BorderWidth - 0; 
gd.CssClass - "list-line"; 
gd.CellPadding - 3; 
gd.CellSpacing m 
gd.HeaderStyle.CssClass - "barbg"; 
gd.HeaderStyle.HorizontalAlign = HorizontalAlign.Center; 
gd.RowStyle.CssClass - "listbg"; 


FN 
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string returnString = string.Empty; 


using (System.IO.StringWriter sw = new System.IO.StringWriter()) ( 
HtmlTextWriter htw = new HtmlTextWriter (sw); 
gd.RenderControl (htw); 
htw.Flush(); 
string tempStr - sw.ToString(); 
returnString += tempStr; 
) 
return returnString; 


) 
该 方法 利用 GridView 与 HtmlTextWriter 类 将 数据 表 中 的 内 容 转换 为 表格 格式 的 HTML. 字符 


LE 


为 了 使 表格 美观 ， 需 要 利用 本 书 提供 的 样式 文件 ， 在 Default.aspx 页 面 的 title 标签 下 面 加 入 如 


ANS: 


<link href-"css/stylel.css" type="text/css" rel-"stylesheet"/» 


编译 并 运行 程序 , 这 时 在 下 拉 列 表 框 中 选择 不 同 的 图 层 , 可 看 到 该 图 层 的 所 有 字段 及 其 数据 类 


型 的 列表 ， 效 果 如 图 4.32 所 示 。 
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图 4.32 图 层 字段 信息 查询 


通过 运行 该 应 用 程序 ， 读 者 可 以 看 到 在 利用 了 Callback 机 制 以 后 ， 没 有 了 原来 那 种 剧烈 的 页 


面 的 刷新 ， 用 户 体验 得 到 了 非常 大 的 提高 。 


此 外 ， 对 于 Web 地 理 信息 系统 ， 另 一 个 需要 特别 强调 的 是 系统 的 响应 速度 。 有 许多 方法 来 提 
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升 系统 的 速度 ， 例 如 利用 缓存 。 

对 于 上 面 这 个 应 用 程序 , 我 们 可 以 将 查询 得 到 的 图 层 字段 信息 缓存 起 来 , 这 样 第 一 个 用 户 调用 
时 ， 我 们 需要 通过 ShowFieldInfo 方法 从 地 图 服务 器 上 获取 信息 ， 当 第 二 个 用 户 或 第 二 次 调用 时 ， 
我 们 可 以 直接 返回 缓存 的 信息 ， 节 省 了 从 地 图 服务 器 中 查询 的 时 间 ， 从 而 提高 了 响应 效率 。 

ASP.NET 提供 了 一 个 强大 的 、 便 于 使 用 的 缓存 机 制 ， 用 于 将 需要 大 量 服务 器 资源 来 创建 的 对 
象 存储 在 内 存 中 。 缓 存 这 些 类 型 的 资源 会 大 大 改进 应 用 程序 的 性 能 。 缓 存 是 由 Cache 类 实现 的 ; 
缓存 实例 是 每 个 应 用 程序 专用 的 。 缓 存 生 存 期 依赖 于 应 用 程序 的 生存 期 ; 重新 启动 应 用 程序 后 ,将 
重新 创建 Cache 对 象 。 

设计 Cache 类 是 为 了 便于 使 用 。 可 以 将 项 放置 在 Cache 中 , 并 在 以 后 使 用 简单 的 键 / 值 对 来 检 
索 这 些 项 。Cache 类 提供 了 强大 的 功能 ， 允 许 自 定义 如 何 缓存 项 以 及 将 它们 缓存 多 长 时 间 。 例 如 ， 
当 缺 乏 系统 内 存 时 ,缓存 会 自动 移 除 很 少 使 用 的 或 优先 级 较 低 的 项 以 释放 内 存 。 该 技术 也 称 为 清理 ， 
这 是 缓存 确保 过 期 数据 不 使 用 宝贵 的 服务 器 资源 的 方式 之 一 。 当 执行 清理 时 ， 可 以 指示 Cache 给 
了 予 某 些 项 比 其 他 项 更 高 的 优先 级 。 若 要 指示 项 的 重要 性 , 可 以 在 使 用 Add 或 Insert 方法 添加 项 时 
指定 一 个 CacheltemPriority 枚 举 值 。 当 使 用 Add 或 Insert 方法 将 项 添加 到 缓存 时 ， 您 还 可 以 建立 
项 的 过 期 策略 。 可 以 通过 使 用 DateTime 值 指定 项 的 确切 过 期 时 间 〈 绝 对 过 期 时 间 ) ， 来 定义 项 的 
生存 期 。 也 可 以 使 用 TimeSpan 值 指定 一 个 弹性 过 期 时 间 ， 弹 性 过 期 时 间 允 许 根据 项 的 上 次 访问 时 
间 来 指定 该 项 过 期 之 前 的 运行 时 间 。 一 旦 项 过 期 , 便 将 它 从 缓存 中 移 除 。 试 图 检索 它 的 值 的 行为 将 
返回 null， 除 非 该 项 被 重新 添加 到 缓存 中 。 

此 外 ，ASP.NET 允许 根据 外 部 文件 、 目 录 《文件 依赖 项 ) 或 另 一 个 缓存 项 〈 键 依赖 项 ) 来 定 
义 缓存 项 的 有 效 性 。 如 果 具 有 关联 依赖 项 的 项 发 生 更 改 ,缓存 项 便 会 失效 并 从 缓存 中 移 除 。 可 以 使 
用 该 技术 在 项 的 数据 源 更 改 时 从 缓存 中 移 除 这 些 项 。 

下 面 的 代码 演示 了 如 何 利用 ASP.NET 提供 的 缓存 机 制 。 首 先 在 GetCallbackResult 方法 的 最 前 
面 加 入 如 下 人 代码， 判断 是 否 存在 某 一 缓存 ， 如 果 存 在 〈 第 二 次 调用 相同 操作 ) ， 则 直接 将 缓存 结果 
返回 ， 如 果 不 存在 〈 首 次 调用 ) ， 则 不 影响 程序 执行 : 

// 判断 是 否 有 相应 的 缓存 信息 

string cachedResponse = Cache[callbackArg] as string; 

if (cachedResponse !- null) 

return cachedResponse; 

) 

然后 在 GetCallbackResult 方法 返回 response 字符 串 代 码 之 前 ， 加 入 如 下 代码 ， 用 于 将 查询 结 
果 保 存 到 缓存 中 : 

TimeSpan cacheDuration = new TimeSpan(0, 0, 999999); 

Cache.Add(callbackArg, response, null, 

DateTime.Now.Add(cacheDuration), 
System.Web.Caching.Cache.NoSlidingExpiration, 
System.Web.Caching.CacheItemPriority.NotRemovable, null); 

上 述 代码 通过 Cache 的 Add 方法 将 查询 结果 缓存 起 来 。 该 方法 的 第 一 个 参数 是 用 于 引用 该 项 
的 缓存 键 ; 第 二 个 参数 是 要 添加 到 缓存 的 项 ; 第 三 个 参数 表示 文件 依赖 项 或 缓存 键 依赖 项 ， 当 任何 
依赖 项 更 改 时 ， 该 对 象 即 无 效 ， 并 从 缓存 中 移 除 。 如 果 没 有 依赖 项 ， 则 此 参数 为 空 引 用 (在 Visual 
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Basic 中 为 Nothing) ; 第 四 个 参数 是 所 添加 对 象 将 过 期 并 被 从 缓存 中 移 除 的 时 间 。 如 果 使 用 可 调 
过 期 ， 则 该 参数 必须 为 NoAbsoluteExpiration; 第 五 个 参数 表示 最 后 一 次 访问 所 添加 对 象 时 与 该 对 
象 过 期 时 之 间 的 时 间 间 隔 。 如 果 该 值 等 效 于 20 分 钟 ， 则 对 象 在 最 后 一 次 被 访问 20 分 钟 之 后 将 过 
期 并 从 缓存 中 移 除 。 如 果 使 用 绝对 过 期 ， 则 该 参数 必须 为 NoSlidingExpiration; 第 六 个 参数 是 对 象 
的 相对 优先 级 ， 由 CacheltemPriority 枚 举 表示 。 缓 存在 退出 对 象 时 使 用 该 值 ， 具 有 较 低 优 先 级 的 
对 象 在 具有 较 高 优先 级 的 对 象 之 前 被 从 缓存 移 除 ; 最 后 一 个 参数 表示 在 从 缓存 中 移 除 对 象 时 所 调用 
的 委托 (如 果 提 供 ) 。 当 从 缓存 中 删除 应 用 程序 的 对 象 时 ， 可 使 用 它 来 通知 应 用 程序 。 
GetCallbackResult 方法 的 完整 代码 如 下 : 


string ICallbackEventHandler.GetCallbackResult () 
{ 
// 判断 是 否 有 相应 的 缓存 信息 
string cachedResponse = Cache[callbackArg] as string; 
if (cachedResponse !- null) 
t 
return cachedResponse; 


} 


// 将 传 入 参数 依据 g 分 割 符 分 到 querystring 变量 中 
Array keyValuePairs = callbackArg.Split ("&".ToCharArray()); 
NameValueCollection queryString = new NameValueCollection(); 
string[] keyValue; 
string response - ""; 
if (keyValuePairs.Length » 0) 
1 
for (int i = 0; i < keyValuePairs.Length; i++) 
t 
keyValue = 
keyValuePairs.GetValue (i).ToString().Split ("-".ToCharArray()); 
queryString.Add(keyValue[0], keyValue[1]); 
) 
) 
else 
{ 
keyValue = callbackArg.Split ("-".ToCharArray()); 
if (keyValue.Length » 0) 
queryString.Add(keyValue[0], keyValue[1]); 
) 


// 针对 参数 中 指定 的 ActiveType 不 同 执行 不 同 操作 
string controlType = queryString["ActiveType"]; 
string eventArg = queryString["EventArg"]; 
switch (controlType) 
t 
case "GetResourceContent": 
response = GisFunctionality.GetResourceContent (Mapl); 
break; 
case "ShowFieldInfo": 


SI9 q3M 


ES 
EB 
D 
un 


j b Web GIS 开发 一 一 ArcGIS Server 与 .NET 


response = GisFunctionality.ShowFieldInfo(Mapl, eventArg); 
break; 
default: 
break; 
) 


TimeSpan cacheDuration = new TimeSpan(0, 0, 999999); 
Cache.Add(callbackArg, response, null, 
DateTime .Now.Add (cacheDuration), 
System.Web.Caching.Cache.NoSlidingExpiration, 
System.Web.Caching.CacheItemPriority.NotRemovable, null); 


return response; 


} 
编译 并 运行 程序 。 可 以 通过 设置 断 点 来 确定 缓存 机 制 是 否 起 到 了 作用 。 
正 由 于 缓存 可 以 很 大 提高 系统 响应 效率 ， 因 此 有 不 少 程序 员 在 这 方面 做 了 不 少 工 作 。 其 中 
Steven Smith 开发 了 一 个 缓存 管理 工具 ， 读 者 可 以 从 http://aspalliance.com/cachemanager/ 地 址 下 载 ， 
也 可 以 从 本 书 的 网 上 随 附 源 代码 文件 中 AttributeQuery 目录 的 bn 文件 夹 中 找到 
(AspAlliance.CacheManager.dll) 。 

利用 工程 的 右键 菜单 的 Add ASPNET Folder 菜单 的 Bin 命令 ， 在 工程 中 加 入 一 名 为 Bin 的 文 
件 夹 ， 将 AspAlliance.CacheManager.dll 文件 拷贝 到 该 文件 夹 中 。 

在 Web.Config 文件 的 <system.web> 与 </system.web> 之 间 加 入 如 下 代码 ， 声 明 访 问 路 径 为 
CacheManager.axd 的 地 址 ， 使 用 CacheManager 类 来 处 理 : 


<httpHandlers> 
«add verb="*" 
path="CacheManager .axd" 
type-"AspAlliance.CacheManager.CacheManagerPageFactory, 
AspAlliance.CacheManager" /> 
«/httpHandlers» 
该 工具 封装 得 如 此 的 好 ， 以 至 通过 上 述 两 个 步骤 就 可 以 使 用 该 工具 来 管理 应 用 程序 的 缓存 了 。 
编译 并 运行 程序 ， 从 下 拉 列 表 框 中 选择 一 个 图 层 ， 查 看 该 图 层 的 字段 信息 。 从 前 面 的 代码 可 以 
知道 ， 上 述 操 作 缓存 了 资源 内 容 信息 〈 程 序 启 动 后 自动 执行 ) 与 选择 图 层 的 字段 信息 。 在 地 址 栏 中 
输入 http://localhost/AttributeQuery/CacheManager.axd 地 址 ， 便 可 看 到 缓存 管理 工具 页 面 ， 切 换 到 
View Cache Entries 页 面 ， 便 可 我 们 上 面 缓存 信息 的 列表 ， 如 图 433 所 示 〈 列 表 中 的 第 一 行 是 
ASP.NET 为 调试 而 进行 的 缓存 信息 ) 。 
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文件 四 
LSU 
Cache Manager 


Cache Manager : Cache Contents 
All cache keys, the type of object they contain, 
and the option to remove the entry. 


Cache Stats 

Server Name BGC, D830-1 
Sv Free Mem 252 
MB 


App Path /AttributeQuery 
App Cache 3 
Entries 


Cache Details 


REMOVE PoweredBy System.Diagnostics.FileVersionInfo Data could not be 
serialized to Xml 


REMOVE ActiveType-GetResourceContent System.String Click to view data 
BEMOVE ActiveType=ShowFisldInfoaEventArg=1 System.String Click to view data 


图 4.33 缓存 管理 工具 页 面 


通过 列表 的 REMOVE 链接 可 以 清除 某 一 个 缓存 ， 还 可 以 通过 click to view data 链接 查看 缓存 
的 数据 。 


4.5.8 ”属性 查询 


知道 每 个 图 层 中 包含 的 字段 及 其 数据 类 型 后 ， 便 可 实现 属性 查询 了 。 

首先 在 Default.aspx 页 面 中 Tocl 控件 的 下 方 与 Labell 控件 的 上 方 , 加 入 一 个 标签 控件 Label2， 
将 其 Text 属性 设置 为 “查询 条 件 : ”。 

在 Label2 控件 的 下 方 与 Labell 控件 的 上 方 ,从 工具 箱 中 的 HTML 选项 卡 中 加 入 一 文本 框 控件 ， 
将 其 id 设置 为 “queryCondition”。 

在 上 述 文本 框 控件 的 下 方 与 Labell 控件 的 上 方 ， 从 工具 箱 中 的 HTML 选项 卡 中 加 入 一 个 按钮 
控件 ， 将 其 id 设置 为 “Query”，value 设置 为 “查询 ”，onclick 设置 为 “AttributeQuery0”。 

由 于 查询 得 到 的 要 素 需要 高 亮 显 示 〈 这 里 介绍 不 同 于 4.4.3 节 的 实现 方法 ) ， 我 们 准备 将 其 绘 
制 到 另 一 个 独立 的 图 形 资源 的 图 层 中 ， 因 此 需要 通过 地 图 资源 管理 器 的 ResourceItems 属性 设置 对 
话 框 加 入 另 一 资源 。 

在 图 4.34 所 示 的 MapResourceltem Collection Editor 对 话 框 中 , 先 通过 Add 按钮 , 加 入 一 资源 ， 
并 将 其 Name 属性 设置 为 “SelectedFeature”， 通 过 向 上 的 箭头 按钮 ， 将 该 资源 的 位 置 调整 到 最 上 
面 。 然后 单 击 其 Definition 属性 ,将 显示 一 个 椭圆 按钮 ， 单 击 该 按钮 ， 弹 出 Map Resource Definition 
Editor 对 话 框 ， 在 Type 的 下 拉 列 表 框 中 选择 “GraphicsLayer”。 选 择 OK 按钮 保存 设置 。 
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NapResourceltem Collection Editor 


Menbers: SelectedFesture properties: 


| —— ra 
ec cms Eum 
回 


日 Appearance 
TisplaySetting visible=True: trar 


Map Resource Definition Editor 
Choose a type from the ist. Click to enter details for data source, 


identity and resource. 


ArcGIS Server Local 
ArcGIS Server Internet 


Fd4.34 增加 GraphicsLayer 类 型 的 资源 


在 Default.aspx 页 面 的 代码 的 JavaScript 函数 部 分 加 入 AttributeQuery0 函 数 的 实现 代码 ， 代 码 
如 下 : 


function AttributeQuery()( 
var layer = document.getElementById ("LayerList"); 
var condition = document.getElementById ("queryCondition"); 
var message = 'ActiveType-AttributeQuery&EventArg-'; 
message *- layer.value; 
message += "&Condtion-" + condition.value; 
var context - 'Pagel'; 
X$-attributeQueryCallBack$» 


s 
B 
fal 
器 


} 
切换 到 Default.aspx.cs 文件 中 ， 在 _Default 类 中 再 加 入 如 下 公用 字段 : 


public string attributeQueryCallBack; 


然后 在 Page Load 方法 中 增加 如 下 代码 ， 生 成 调用 的 客户 端 脚本 : 


attributeQueryCallBack = Page.ClientScript.GetCallbackEventReference( 
this, "message", "processCallbackResult", 
"context", "postBackError", true); 


然后 修改 ICallbackEventHandler.GetCallbackResult() 77 i2; ^£ [9] As [8] ActiveType 执行 不 同 操作 
的 switch 部 分 代码 ， 执 行 属性 查询 图 形 ， 代 码 如 下 : 
// 是 否 进行 缓存 ， 对 于 属性 查询 图 形 不 进行 缓存 


bool needCached = true; 


// 针对 参数 中 指定 的 ActiveType 不 同 执行 不 同 操作 

string controlType = queryString["ActiveType"]; 
String eventArg = queryString["EventArg"]; 
switch (controlType) 
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case "GetResourceContent": 
response = GisFunctionality.GetResourceContent (Mapl); 
break; 
case "ShowFieldInfo": 
response = GisFunctionality.ShowFieldInfo(Mapl, eventArg); 
break; 
case "AttributeQuery": 
response - GisFunctionality.AttributeQuery (Mapl, eventArg, 
queryString["Condtion"]); 
needCached - false; 
break; 
default: 
break; 


if (needCached) 
{ 
TimeSpan cacheDuration = new TimeSpan(0, 0, 999999); 
Cache.Add(callbackArg, response, null, 
DateTime.Now.Add(cacheDuration), 
System.Web.Caching.Cache.NoSlidingExpiration, 
System.Web.Caching.CacheItemPriority.NotRemovable, null); 
) 


return response; 


这 是 由 于 每 个 用 户 每 次 查询 的 内 容 可 能 都 不 一 样 ,因此 没有 


要 将 属性 查询 图 形 的 结果 保存 下 


GisFunctionality 类 的 AttributeQuery 方法 的 代码 如 下 : 


public static string AttributeQuery (Map map, string layerIndex, 
string condition) 
t 
IGISFunctionality gisfunc = map.GetFunctionality ("NorthAmericaMap"); 
if (gisfunc -- null) 
return. "4; 


IGISResource gisresource = gisfunc.Resource; 
bool supportquery = 
gisresource.SupportsFunctionality (typeof (IQueryFunctionality)); 
if (!supportquery) 
return ""; 


IQueryFunctionality qfunc; 

qfunc = gisresource.CreateFunctionality( 
typeof (IQueryFunctionality), null) 
as IQueryFunctionality; 


SpatialFilter spatialfilter = new SpatialFilter(); 
spatialfilter.ReturnADFGeometries = false; 


SI9 q3M 


© b Web GIS 开发 一 一 ArcGIS Server 与 .NET 


S19 qam 


j 
在 


spatialfilter.MaxRecords = 1000; 
spatialfilter.WhereClause = condition; 


System.Data.DataTable datatable = qfunc.Query( 
null, layerIndex, spatialfilter); 
if (datatable == null) 
return ""; 


return HighlightShow (map, datatable); 


上 面 的 代码 中 ， 先 得 到 NorthAmericaMap 的 查询 功能 对 象 ， 然 后 利用 此 功能 的 Query 方法 ， 


配合 SpatialFilter 对 象 ， 执 行 空间 查询 ， 得 到 查询 结果 ， 保 存 到 数据 表 中 。 最 后 调用 HighlightShow 


方法 高 
Hi 


亮 显示 满足 条 件 的 要 素 。 
ghlightShow 方法 的 代码 如 下 : 


private static string HighlightShow(Map map, DataTable datatable) 


j| 


IGISFunctionality gisfunc = map.GetFunctionality ("SelectedFeature"); 
if (gisfunc null) 
return ""; 


ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource gResource - null; 
gResource - gisfunc.Resource as 
ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource; 
if (gResource -- null) 
return ""; 


// 从 SelectedFeature 资源 中 寻找 ElementGraphicsLayer 

ElementGraphicsLayer gLayer - null; 

foreach (System.Data.DataTable dt in gResource.Graphics.Tables) ( 
if (dt is ElementGraphicsLayer) 


{ 
gLayer = (ElementGraphicsLayer)dt; 


} 


// 第 一 次 调用 时 ElementGraphicsLayer 不 存在 ， 需 要 创建 一 个 
if (gLayer == null) { 
gLayer = new ElementGraphicsLayer(); 
gResource.Graphics.Tables.Add (gLayer); 
) 


// 清除 已 有 数据 


gLayer.Clear(); 
DataRowCollection drs = datatable.Rows; 


int shpind = —1; 
forc (int i 0; i < datatable.Columns.Count; i++) { 
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编译 并 运行 程序 。 在 文本 框 中 输入 合适 的 条 件 , 然后 选择 查询 按钮 ， 系 统 将 高 亮 显示 满足 条 件 
的 要 素 ， 效 果 如 图 4.35 所 示 。 
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apiadTypeDID 


eriFildT ype Deonetry 
AREA esriFisldTypeDoutle 


STATE NAME. eenFiadTypeSting 


STATE FIPS — eriFiadType3ting 
SUB REGICN — emFeldTypestung 


STATE ARAR ageuroreshiny 
DLE 


图 4.35 属性 查询 图 形 的 效果 


46 ”右键 菜单 与 地 图 图 片 保存 


由 于 地 图 控件 自身 就 支持 用 鼠标 深 轴 来 放大 、 缩小 , 用 方向 键 来 漫游 以 及 用 鼠标 左 键 拖 动 来 温 
游 ， 因 此 如 果 系 统 功能 相对 简单 ， 就 没有 必要 保留 工具 栏 ， 可 将 一 些 不 能 通过 鼠标 与 键盘 直接 实现 
的 操作 ， 放 到 右键 菜单 中 ， 从 而 使 地 图 尽 可 能 占据 大 的 空间 。 

Web ADF 提供 有 一 个 名 为 ContextMenu 控件 。 通过 该 控件 便 可 为 应 用 程序 提供 右键 菜单 功能 。 
每 个 ContextMenu 控件 可 包含 一 个 或 多 个 菜单 项 ， 而 每 个 菜单 项 与 一 段 客 户 端 或 服务 器 端 代码 相 
连 。 此 外 ， 每 个 菜单 项 可 以 同时 显示 一 个 图 表 以 及 文字 (也 可 只 显示 文字 或 图 标 ) 。 要 注意 的 是 
Toc 控件 与 TaskResult 控件 自身 就 包含 了 右键 菜单 用 于 控制 其 中 的 节点 。 

本 节 将 结合 实现 全 图 显示 与 将 当前 地 图 保存 为 图 片 功能 演示 如 何 使 用 右键 菜单 。 为 了 更 好 地 演 
示 , 在 本 实例 中 利用 两 个 地 图 资源 ， 一 个 是 前 面 经 常 使 用 的 NorthAmericaMap， 另 一 个 是 还 没有 发 布 
的 地 图 资源 。 因 此 请 读者 按照 第 3 章 介 绍 的 方法 将 C:\ProgramFiles\ArcGIS\ DeveloperKit'SamplesNET 
Server\data\Usa\USA_Data.mxd 地 图 文档 发 布 为 名 为 USAMap 的 地 图 服务 。 


4.6.1 添加 右键 菜单 


在 Visual Studio 中 利用 File 菜单 的 New Web Site 命令 ,创建 一 个 名 为 ContextMenu 的 Web 工程 。 
在 Defaultaspx 页 面 中 加 入 一 个 地 图 控件 与 一 个 地 图 资源 管理 器 控件 ， 分 别 命名 为 Map1l 与 
MapResourceManagerl1。 将 地 图 控件 的 MapResourceManager 属性 指定 为 MapResourceManagerl, 
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从 而 使 两 个 控件 连接 起 来 。 


打开 地 图 资源 管理 器 控件 的 Resourceltems 属性 设置 对 话 框 ,先后 加 入 两 个 ArcGIS Server Local 
资源 USAMap 与 NorthAmericaMap, 确保 USAMap 在 NorthAmericaMap 的 上 面 . 为 了 不 使 USAMap 
资源 中 的 地 图 的 背景 覆盖 NorthAmericaMap 资源 的 地 图 ， 需 要 通过 其 DisplaySetting 属性 将 资源 的 
背景 设置 为 透明 。 该 属性 设置 对 话 框 如 图 4.36 所 示 ， 在 该 对 话 框 中 将 透明 背景 颜色 设置 为 白色 ， 
并 选择 Make background transparent， 即 背景 透明 。 


Nap Resource Display Settings Editor 


Map Resource Display Settings Editor 
Set transparency and blending settings. 


Transparency Settings 
Display this color as Inite lal 
[V] Wake background transparent 


Üransparent color should be set to make background transpa 


Blending With Other Map Resources 


Transparency 0 t D) 


(There may be a performance penalty if Transparency is n 


[V] Request MINE Data Image Format PNGS { 
[7] Visible [V] Display in the Table of Contents 


[57 Ceci 
图 4.36 演示 方式 设置 对 话 框 


ContextMenu 控件 没有 集成 到 Visual Studio 的 工具 箱 中 。 因 此 ， 要 使 用 该 控件 ， 可 直接 在 页 面 
中 添加 引用 , 或 是 先 将 该 控件 加 入 到 Visual Studio 的 工具 箱 中 , 然后 通过 鼠标 拖 动 加 入 到 页 面 , HE 
荐 使 用 后 者 。 

将 ContextMenu 控件 加 入 到 Visual Studio 的 工具 箱 中 很 容易 , 首先 在 工具 箱 中 展开 ArcGIS Web 
Controls 选项 卡 ,然后 选择 其 右键 菜单 的 Choose Items. .命令 ,打开 如 图 4.37 所 示 的 Choose Toolbox 
Items 对 话 框 。 在 该 对 话 框 中 定位 并 选择 命名 空间 为 ESRIArcGIS.ADF.ULWebControls 的 
ContextMenu 控件 。 选 择 OK 关闭 对 话 框 。 此 时 该 控件 应 该 出 现在 工具 箱 中 了 。 


Choose Toolbox Items 


RR 
[CNET Framework Conponents [CoM Cosponents| 


Im Namespace Assenbly Name s 
| [V] ContentPlaceHolder System. Web. UI WebControls System. Web (2.0.0.0) 
| | [V] ContextMenu Systen. Windows. Forms System. Windows. Fo. 
ContextMenu Systen. Windows. Form: System. Windows. Fo. 
国 ESRI. eb. UT. WebControls ESR S. ADF. Y. 
O Contextllenu Systen. Windows. Forms System. Windows. Fo. 
[V] ContextMenuStrip — System. Windows. Forms System. Windows. Fo. 
| | O Control Systen. Windows. Forms System. Windows. Fo. 
E] Control Systen. Web. UI System. Web (2.0.0.0) $ 
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Filter: 
Contextllenu. 
Language: Invariant Language (Invariant Country) 
a Version: 9.2.0. 1324 


[Ree ) 
图 4.37 增加 工具 对 话 框 
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在 Default.aspx 中 加 入 ContextMenu 控件 , 命名 为 ContextMenul。 注意 ContextMenu 控件 在 设 
计 期 间 的 位 置 并 会 不 决定 运行 期 间 右键 菜单 的 位 置 。 

将 ContextMenul 控件 的 BackColor 属性 设置 为 白色 。 该 属性 默认 值 为 透明 。 

Web ADF 没有 为 ContextMenu 控件 在 设计 期 间 提供 设计 菜单 项 的 对 话 框 ， 因 此 需要 通过 代码 来 
实现 。 可 以 用 ContextMenultem 类 来 创建 菜单 项 。ContextMenuItem 类 的 参数 中 包含 一 个 图 标的 url, 
菜单 项 的 文字 以 及 一 代表 当 用 户 选择 该 菜单 项 所 执行 的 JavaScript 代码 。 最 合适 加 入 菜单 项 的 时 间 应 
该 是 页 面 加载 时 。 因 此 首先 在 Page Load 方法 中 加 入 如 下 代码 ， 用 于 在 菜单 中 添加 两 个 菜单 项 : 


if (IsPostBack) 
return; 


ESRI.ArcGIS.ADF.Web.UI.WebControls.ContextMenuItem fullextMenuItem = 
new ESRI.ArcGIS.ADF.Web.UI.WebControls.ContextMenuItem( 
"images/fullextent.jpg", "4E", null); 


ESRI.ArcGIS.ADF.Web.UI.WebControls.ContextMenuItem saveMenuItem = 
new ESRI.ArcGIS.ADF.Web.UI.WebControls.ContextMenuItem( 
"images/save.jpg", "另存 为 图 片 "，nul11); 


ContextMenul.Items.Add(fullextMenuItem); 

ContextMenul.Items.Add(saveMenuItem); 

为 了 显示 右键 菜单 ,需要 在 合适 的 控件 上 增加 事件 。 本 实例 中 , 希望 当 用 户 右键 单 击 地 图 时 显 
示 右 键 菜单 。 在 运行 期 间 ， 地 图 控件 在 浏览 器 中 创建 了 一 个 Div 来 显示 地 图 数据 ， 因 此 可 使 用 该 
Div 的 属性 来 设置 。 其 中 oncontextmenu 属性 使 浏览 器 监听 右键 单 击 事件 。 当 事件 触发 时 ， 使 用 
JavaScript 代码 来 显示 该 右键 菜单 及 其 菜单 项 。Web ADF 提供 了 一 系列 的 JavaScript 函数 来 显示 与 
隐藏 右键 菜单 。 在 本 实例 中 ， 当 地 图 oncontextmenu 事件 触发 时 ，JavaScript 函数 
esriShowContextMenu() 将 被 调用 ， 并 显示 右键 菜单 。 在 Page Load 方法 中 再 加 入 如 下 代码 : 

string format = "esriShowContextMenu (event, '(0)', '(1] ', ' (2) ') ;return false;"; 


string showContextMenu - string.Format(format, ContextMenul.ClientID, 
Mapl.UniqueID, ""); 


Mapl.Attributes.Add("oncontextmenu", showContextMenu); 


4.6.2 ”处 理 右 键 菜单 事件 


在 程序 运行 期 间 一 旦 显示 了 右键 菜单 , 用 户 便 应 可 以 选择 某 菜单 项 来 启动 一 个 动作 , 此 时 触发 
的 是 ContextMenu 控件 的 ItemClicked 事件 。 当 一 菜单 项 被 选择 时 ， 一 个 回调 请 求 就 会 发 送 到 包含 
菜单 的 页 面 。 可 以 通过 菜单 项 的 Text 属性 来 判断 用 户 选择 的 是 哪个 菜单 项 。 要 注意 的 是 ， 
ContextMenu 控件 生成 的 回调 响应 规定 由 Web ADF JavaScript 来 处 理 ， 因 此 ， 如 果 页 面 中 其 他 控件 
的 内 容 改 变 必须 打包 成 CallbackResults， 并 加 入 到 ContextMenu 的 CallbackResults 属性 中 。 

在 属性 设置 面板 中 ， 双 击 ContextMenul 的 ItemCliked 事件 ， 生 成 事件 响应 方法 
ContextMenul_ItemClicked。 在 其 中 加 入 如 下 代码 (另存 为 图 片 功 能 在 下 一 小 节 中 实现 ): 
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switch (args.Item.Text) { 
case "全 图 ": ( 
MapHelper.ShowFullEextent (Map1) ; 
ContextMenul.CallbackResults.CopyFrom (Mapl.CallbackResults); 
break; 


} 


在 上 述 代码 中 调用 了 MapHelper 类 的 ShowFullEextent 方法 实现 显示 全 图 范 上 
在 工程 中 加 入 App Code 目录 ， 然 后 在 其 中 加 入 C# 类 MapHelper。 在 p HAMM cs 的 头 部 
加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web.UI.WebControls; 

using ESRI.ArcGIS.ADF.Web.DataSources; 

using ESRI.ArcGIS.ADF.ArcGISServer; 

using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 


ShowFullEextent 方法 的 代码 如 下 : 


H 


public static void ShowFullEextent (Map map) 
1 
ESRI.ArcGIS.ADF.Web.Geometry.Envelope fullExtent - null; 
foreach (IMapFunctionality imf in map.GetFunctionalities()) ( 
MapFunctionality mf - imf as MapFunctionality; 
ESRI.ArcGIS.ADF.ArcGISServer.MapDescription mapDescription = 
mf.MapDescription; 
ESRI.ArcGIS.ADF.ArcGISServer.Envelope envServer - 
mapDescription.MapArea.Extent; 
ESRI.ArcGIS.ADF.Web.Geometry.Envelope env - null; 
env = ESRI.ArcGIS.ADF.Web.DataSources. 
ArcGISServer.Converter.ToAdfGeometry (envServer) 
as ESRI.ArcGIS.ADF.Web.Geometry.Envelope; 
if (fullExtent == null) ( 
fullExtent - env; 
) 
else ( 
fullExtent.Union (env); 


map.Extent = fullExtent; 
map.Refresh(); 

) 

在 上 述 代码 中 ， 我 们 对 地 图 中 的 所 有 绘图 功能 进行 循环 ， 当 然 对 于 本 实例 分 别 是 USAMap 5 
NorthAmericaMap ， 得 到 每 个 绘图 功能 的 地 图 描述 对 象 (MapDescription ) ， 通 过 该 对 象 的 
Map.Area.Extent 属性 ， 得 到 该 地 图 的 坐标 范围 ， 然 后 将 这 些 范 围 进行 Union 操作 ， 得 到 整个 地 图 
的 坐标 返回 ， 最 后 将 该 坐标 返回 设置 为 地 图 当前 显示 返回 ， 即 实现 全 图 显示 。 

编译 并 运行 程序 。 先 用 鼠标 深 轴 放大 或 缩小 地 图 , 然后 通过 右键 菜单 的 “全 图 ”命令 即 可 返回 。 
程序 运行 界面 如 图 4.38 所 示 。 
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图 4.38 程序 运行 效果 


4.6.3 ”保存 地 图 图 片 


下 面 要 实现 的 是 右键 菜单 的 图 片 保存 功能 。 

对 于 包括 多 个 资源 的 地 图 控件 (本 实例 就 如 此 ) ,将 生成 多 张 图 片 。 这 些 地 图 图 片 在 浏览 器 端 
或 是 在 Web 服务 器 端 融 合 ， 尽 管用 户 看 似 是 一 张 完 整 的 地 图 ,实际 上 包含 了 许多 县 加 图 片 。 这 时 ， 
需要 将 所 有 图 片 融合 成 一 张 图 片 在 地 图 控件 之 外 使 用 。 生 成 一 张 可 打印 的 图 片 。 下 面 将 演示 如 何 使 
用 .NET 的 GDI+ 来 生成 一 张 融 合 好 的 图 片 。 

在 ContextMenul ItemClicked 方法 的 switch 块 中 加 入 如 下 代码 ， 用 于 响应 “另存 为 图 片 ” 荣 
单项 : 

case "另存 为 图 片 ": { 

MapHelper.SaveAsPicture (Mapl); 
ContextMenul.CallbackResults.CopyFrom (Mapl.CallbackResults); 


break; 


) 
MapHelper 类 的 SaveAsPicture 方法 的 代码 如 下 : 


public static void SaveAsPicture (Map map) 
ü 
int imgHeight = (int)map.Height.Value; 
int imgWidth = (int)map.Width.Value; 
System.Collections.Generic.IList«Bitmap» bitmaps = 
new System.Collections.Generic.List«Bitmap» (); 


foreach (IMapFunctionality mf in map.GetFunctionalities()) ( 
ESRI.ArcGIS.ADF.Web.MapImage mi = mf.DrawExtent (map.Extent); 
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if (mi != null) 
bitmaps .Add (mi.GetImage()); 


Bitmap newImg = new Bitmap (imgWidth, imgHeight); 

Graphics imgGraphics = Graphics .FromImage (newImg); 

imgGraphics.FillRectangle (new SolidBrush (System.Drawing.Color.LightGray), 
0, 0, imgWidth, imgHeight); 


for (int j = bitmaps.Count - 1; j >= 0; j--) ( 
Bitmap bmp = bitmaps[jl:; 
imgGraphics.DrawImage (bmp, 0, 0, imgWidth, imgHeight); 


) 
string fileNameVirtual = System.DateTime.Now.ToString() + ".jpg"; 
fileNameVirtual = fileNameVirtual.Replace(":", "-"); 


string fileName = map.Page.MapPath("OutputNNA" + fileNameVirtual); 
newImg.Save(fileName, System.Drawing.Imaging.ImageFormat.Jpeg); 
imgGraphics.Dispose(); 

newImg.Dispose(); 


string functionValue = "open('SavePicture.aspx?FileName-" + 
fileNameVirtual + "', 'SavePicture');"; 
object[] oa = new object[1]; 
oa[0] = functionValue; 
CallbackResult cr = new CallbackResult( 
null, null, "javascript", functionValue); 
map.CallbackResults.Add(cr); 

) 

在 上 述 代 码 中 ， 先 对 地 图 中 的 所 有 绘图 功能 进行 循环 ,将 所 生成 的 图 片 加 入 到 一 个 列表 中 ， 接 
着 利用 GDI+ 方 法 将 列表 中 的 图 片 绘制 成 一 个 图 片 ， 然 后 将 该 图 片 保存 在 Output 目录 下 (需要 读者 
在 工程 中 加 入 该 目录 ) ， 最 后 构造 JavaScript 代码 ， 新 打开 一 窗口 ， 以 图 片 的 文件 名 为 参数 显示 
SavePicture.aspx 页 面 。 我 们 将 在 该 页 面 中 实现 显示 或 保存 图 片 操作 。 


SavePicture.aspx 是 一 虚拟 的 页 面 ， 对 应 的 是 一 个 实现 了 System.Web.IHttpHandler 接口 的 类 。 


切换 到 Web.Config 文件 中 ，<system.web> 与 </system .web> 之 间 加 入 如 下 代码 ， 声 明 地 址 为 
SavePicture.aspx 的 访问 ， 由 DownloadMapHandler 类 来 处 理 : 


<httpHandlers> 
<add verb="*" path="SavePicture.aspx" type="DownloadMapHandler"/> 
</httpHandlers> 


在 App Code 目录 中 加 入 C# 类 DownloadMapHandler。 该 类 的 代码 如 下 : 


public class DownloadMapHandler : System.Web.IHttpHandler { 
#region IHttpHandler Members 


bool IHttpHandler.IsReusable { 
get ( 
return true; 
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编译 并 运行 程序 ， 检 查 并 执行 保存 图 片 功能 。 


源 、 资 源 与 功能 对 象 


在 第 4 章 中 我 们 主要 使 用 的 数据 源 是 ArcGIS Server 的 本 地 服务 , 但 是 正如 前 面 经常 提 到 
ij, Web ADF 为 了 更 好 的 支持 多 数据 源 ， 在 COM 对 象 的 基础 上 , 增加 了 ADF 9.0/9.1 没有 的 
公有 API、 值 对 象 等 开发 展 次。 同时 ,提供 了 更 好 的 控制 粒度 。 在 值 对 象 以 及 COM 对 象 之 间 ， 
可 以 根据 需要 (如 提高 性 能 等 ) ， 按 照 一 定 的 分 层 设 计 规 范 的 使 用 。 在 这 一 章 中 我 们 将 介绍 
这 些 不 同 的 数据 源 及 其 对 应 的 资源 与 功能 对 象 的 使 用 。 

通过 本 章 你 将 了 解 到 : 


5.1 数据 源 

52 公有 数据 源 API 

5.3 ArcGIS Server 数据 源 的 使 用 
5.4 ”操作 资源 与 功能 对 象 
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5.1 数据 源 


Web ADF 控件 可 以 使 用 多 种 来 源 的 数据 , 包括 本 地 或 远程 连接 的 ArcGIS Server 服务 、ArcIMS 
服务 、ArcWeb 服务 、WMS 服务 以 及 Web ADF 的 图 形 数据 。Web ADF 的 一 个 主要 优势 是 能 同时 
显示 一 个 或 多 个 数据 源 生成 的 多 个 地 图 , 并 通过 地 图 控件 来 显示 , 而 不 需要 开发 人 员 编 写 任何 代码 。 
在 Web ADF 中 ， 将 数据 源 定义 为 资源 ， 数 据 源 的 能 力 决定 了 资源 的 能 力 及 其 所 能 提供 的 功能 。 

Web ADF 中 使 用 的 任何 数据 源 实质 上 是 一 自 定义 的 数据 源 ， 它 们 通过 实现 Web ADF 的 公有 
数据 源 API 接口 ， 插 入 到 Web ADF 中 。 基 本 上 每 种 数据 源 都 有 一 个 特有 API， 只 能 供 该 数据 源 使 
用 。 要 在 Web ADF 中 将 某 数据 源 作 为 资源 来 使 用 ， 那 么 必须 实现 相应 的 公有 API 的 接口 与 类 。 数 
据 源 的 功能 决定 了 需要 实现 哪些 接口 与 类 。 例 如 ESRLArcGIS.ADF.ArcGISServer. 程序 集 包 含 与 
ArcGIS Server SOAP API 关联 的 SOAP 代理 对 象 与 值 对 象 , 除了 提供 自身 使 用 之 外 , 还 可 以 供 Web 
ADF 控件 与 API 之 外 的 其 他 类 来 访问 ArcGIS Server 服务 。 为 了 在 Web ADF 中 将 ArcGIS Server 
的 服务 作为 一 个 数据 源 ，ArcGIS Server SOAP API 提供 了 ESRI.ArcGIS.ADF.Web.DataSources.Arc 
GISServer 程序 集 , 该 程序 集 实现 了 公有 API 的 接口 。Web ADF 就 是 利用 该 程序 集 来 使 用 本 地 与 远 
程 ArcGIS Server 数据 源 的 。 

Web ADF 中 每 个 数据 源 都 有 自己 的 类 库 ， 都 包含 在 ESRIArcGIS.ADF.Web.DataSources 命名 
空间 中 。 数 据 源 的 类 库 包 含 了 资源 与 功能 类 ， 通 过 这 些 类 访问 数据 源 的 基本 能 力 。 例 如 ， 如 果 一 个 
数据 源 能 生成 一 张 地 图 ,那么 它 就 支持 地 图 资源 CMapResource) 与 绘图 功能 (MapFunctionality) 。 
地 图 控件 以 及 开发 人 员 利 用 地 图 资源 创建 绘图 功能 ， 并 由 绘图 功能 生成 地 图 。 


5.1.1 ArcGIS Server 本 地 数据 源 


一 个 ArcGIS Server 本 地 数据 源 代 表 在 局 域 网 中 ， 通 过 服务 器 对 象 管理 器 〈SOM) 连接 一 个 
ArcGIS Server 服务 。 为 了 连接 服务 ， 必 须 指定 服 务 器 的 名 称 (或 他 地 址 ) 与 服务 的 名 称 ， 此 外 还 
需要 提供 身份 信息 ， 该 身份 需要 是 装 有 SOM 计算 机 中 agsusers 或 agsadmin 用 户 组 中 的 成 员 。 

ArcGIS Server 本 地 数据 源 可 代表 ArcGIS Server 地 图 服务 、 地 理 编码 服务 以 及 空间 处 理 服务 。 
本 地 数据 源 允 许 开 发 人 员 通 过 服务 器 上 下 文 对象 来 操作 细 粒 度 的 ArcObjects, 因此 可 以 在 Web ADF 
应 用 程序 中 利用 ArcObjects 的 强大 功能 ， 例 如 编辑 要 素 图 层 、 网 络 分 析 以 及 投影 转换 等 。 

在 程序 中 可 以 通过 ArcGIS Server 数据 源 类 库 ( ESRLArcGIS.ADF.Web.DataSource. 
ArcGISServer) ,来 连接 与 操作 ArcGIS Server 本 地 数据 源 。 通过 该 程序 集中 的 MapFunctionality 类 ， 
可 以 访问 地 图 描述 信息 ， 甚 至 使 用 ArcGIS Server SOAP API。ArcGIS Server 本 地 资源 ， 例 如 
MapResourceLocal, 同时 提供 了 通过 ServerContextInfo.ServerContext 属性 来 访问 服务 器 的 上 下 文 对 
象 。 通 常 ， 与 ArcGIS Server 本 地 数据 源 打交道 的 资源 类 的 类 名 以 “Local” 结 束 ， 例 如 Web ADF 
中 的 MapResourceLocal 类 。 
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5.1.2 ArcGIS Server 远程 数据 源 


选择 ArcGIS Server 远程 数据 源 意 味 着 客户 端 将 通过 Web 服务 端点 来 访问 ArcGIS Server 服务 。 
ArcGIS Server 服务 提供 一 WSDL (Web Service Description Language，Web 服务 描述 语言 ) ， 客 户 
端 可 利用 该 WSDL 在 开发 环境 中 生成 ArcGIS Server SOPA API 相应 的 代理 类 。 对 于 ArcGIS Server 
服务 ，SOAP API 只 提供 了 ArcObjects 的 部 分 功能 ， 即 无 状态 那 部 分 功能 ， 因 此 ArcGIS Server 远 
程 数据 源 只 能 与 ArcGIS Server 服务 使 用 无 状态 方式 交互 。 同 时 由 于 不 能 通过 ArcGIS Server 远程 数 
据 源 得 到 服务 器 上 下 文 ， 因 此 细 粒 度 的 ArcObjects 功能 也 不 能 使 用 。 

ArcGIS Server 远程 数据 源 可 以 是 地 图 服务 、 地 理 编码 服务 以 及 空间 处 理 服 务 。 在 地 图 资源 管 
理 器 中 ， 当 设置 ArcGIS Server 远程 连接 时 ， 应 提供 包含 服务 的 服务 器 的 URL， 格 式 一 般 是 
http://serverIP/arcgis/services， 然 后 输入 认证 信息 ， 最 后 从 服务 下 拉 列 表 框 中 选择 一 个 服务 ， 如 图 
5.1 所 示 。 


Map Resource Definition Editor 
Choose a type from the list. Click to enter details for data source, 
identity and resource. 


ArcGIS Resource Definition Editor 
Select a service and a dela frame. 


Service: am m 


CE 


Data Frane: (default) M 


Cm) 


图 5.1 ArcGIS Server 远程 数据 源 的 连接 


ArcGIS Server 远程 数据 源 必须 是 池 化 的 GIS 服务 。 池 化 的 服务 可 以 让 Web 应 用 程序 在 用 户 之 
间 共 享 。 非 池 化 的 GIS 服务 的 实例 为 单独 的 用 户 占 有 ， 当 用 户 操作 完成 后 ， 该 实例 被 销毁 。 如 果 
在 远程 连接 中 使 用 非 池 化 的 服务 ， 那 么 每 个 地 图 或 其 他 GIS 的 操作 都 会 创建 与 销毁 一 个 新 的 进程 ， 
这 将 导致 GIS 服务 器 资源 的 低 效率 使 用 。 

可 以 通过 ArcGIS Server 数据 源 类 库 (ESRI.ArcGIS.ADF.Web.DataSource. ArcGISServer) , X 
连接 与 操作 ArcGIS Server 远程 数据 源 。 通 常 与 ArcGIS Server 远程 数据 源 打 交道 的 类 的 名 称 以 
“Internet” 结 束 ， 例 如 MapResourcelInternet. 


5.1.3 ArcIMS 


若 在 地 图 资源 管理 器 设置 地 图 资源 的 对 话 框 中 选择 ArcIMS 数据 源 ， 还 需要 进一步 设置 使 用 
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TCP 或 HTTP 来 访问 ， 如 图 5.2 所 示 。 对 于 TCP 连接 ， 需 要 指定 ArcIMS 应 用 服务 器 的 IP 地 址 与 
端口 号 (默认 为 5300〉。 对 于 HTTP 连接 ， 需 要 指定 ArcIMS 的 servlet 连接 的 URL. 


Map Resource Definition Editor 
Choose a lype fron the kst. Cick to enter detal for data source. 
ideriay ard resource. 


| ArcIMS Data Source Definition Editor 
Type the host and port or URL of your server. 


Server Connection 


Additional TIS Servers 


图 5.2 连接 ArcIMS 服务 的 两 种 方式 的 设置 
ArcIMS 数据 源 在 程序 中 的 访问 是 使 用 ArcIMS 数据 源 类 库 ESRLArcGIS.ADF.Web.DataSource. 
IMS 来 进行 .通过 该 类 库 中 的 MapFunctionality 类 , 可 以 访问 MapView 类 .同时 ,还 可 以 通过 ArcIMS 
特有 的 API 通过 ArcXML 访问 更 细 粒 度 的 功能 。 


三 
EB 
m 
un 


5.1.4. 图 形 图 层 


图 形 图 层 用 于 在 Web 服务 器 端 快速 显示 地 理 要 素 。 这 些 要 素 可 以 是 也 可 以 不 是 来 源 于 ArcGIS 
Server 服务 、WMS 服务 或 ArcIMS 服务 。 例 如 ， 可 以 对 地 图 中 已 有 的 服务 进行 地 理 编 码 操作 ， 返 
回 一 点 图 形 数据 表 。 

可 以 在 地 图 资源 管理 器 中 通过 加 入 一 类 型 为 “GraphicsLayer” 的 地 图 资源 ， 作 为 图 形 数据 源 。 
图 形 资源 的 类 型 是 System.Data.DataSet， 即 数据 集 ， 因 此 可 以 包含 许多 数据 表 。 通 过 图 形 资源 的 
Graphics 属性 来 访问 Web ADF 的 GraphicsDataSet 类 。 

Web ADF 中 有 两 类 图 形 图 层 ， 分 别 是 ElementGraphicsLayer 与 FeatureGraphicsLayer， 都 属于 
System.Data.DataTable 类 型 , 因此 可 以 加 入 到 GraphicsDataSet 数据 表 集 合 中 。 图 形 图 层 的 内 容 存 储 
在 应 用 程序 的 内 存 中 , 因此 ， 图 形 图 层 中 内 容 的 大 小 与 应 用 程序 需要 的 内 存 成 正比 。 还 需要 注意 的 
是 ， 只 能 通过 程序 代码 来 创建 与 管理 图 形 图 层 。 

O ElementGraphicsLayer 类 用 来 存储 基本 的 图 形 元 素 ， 即 几何 图 形 与 符号 。 一 个 

ElementGraphicsLayer 可 以 存储 不 同类 型 的 几何 图 形 。 通 常 ， 不 用 来 存储 属性 ， 常 用 来 显 
示 地 图 中 选择 的 要 素 ; 
D) FeatureGraphicsLayer 类 用 来 仿真 一 真实 的 要 素 图 层 。 每 个 FeatureGraphicsLayer 只 支持 一 
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类 几何 图 形 .Web ADF 可 以 依据 数据 表 中 的 属性 来 符号 化 几何 图 形 .FeatureGraphicsLayer 
同时 还 支持 查询 。 


Web ADF 在 图 形 图 层 资源 中 绘制 每 个 图 形 图 层 ， 因 此 ，Web ADF 同时 也 提供 了 一 系列 的 几何 
类 型 、 符 号 。 


5.22 ”公有 数据 源 API 


在 4.2 节 中 我 们 简单 介绍 了 公有 数据 源 API (或 简称 为 公有 APD 的 基本 结构 ， 但 并 没有 深入 
说 明 ， 因 此 在 本 节 中 再 详细 介绍 。 


5.2.1 公有 数据 源 API 的 内 容 


Web ADF 使 用 公有 API 来 处 理 多 种 数据 源 。 公 有 API 是 Web ADF 中 最 重要 的 部 分 ， 因 此 它 
为 在 Web ADF 中 使 用 数据 源 提 供 了 一 抽象 的 框架 。 公 有 API 的 最 基础 的 三 个 接口 分 别 是 : 
IGISDataSource 〈 数 据 源 接 口 ) 、IGISResource〈 资 源 接口 ) 与 IGISFunctionality 〈 功 能 接口 ) 。 

通常 ， 在 Web ADF 中 ， 代 码 是 通过 资源 与 功能 对 外 提供 的 。 一 个 数据 源 可 以 有 一 个 或 多 个 资 
W, 一 个 资源 可 以 有 一 个 或 多 个 功能 。 数据 源 的 类 型 决定 了 可 供 使 用 的 资源 的 类 型 ,而 数据 源 的 能 
力 决定 了 通过 资源 可 访问 的 功能 的 类 型 。 公 有 API 提供 了 一 组 标准 的 资源 与 功能 接口 ， 数 据 源 需 
要 实现 这 些 接口 。 表 5-1 列 出 了 Web ADF 中 的 资源 接口 及 其 说 明 。 资 源 接口 都 继承 于 IGISResource。 


表 5-1 Web ADF 中 的 资源 接口 及 其 说 明 


资源 说 明 

IMapResource 根据 要 素 或 影像 数据 绘制 地 图 的 数据 源 
IGeocodeResource 支持 地 址 匹配 的 数据 源 
IGeoprocessingResource 支持 空间 处 理 分 析 的 数据 源 


功能 接口 都 继承 于 IGISFunctionality, 每 一 个 功能 只 能 与 一 个 类 型 的 资源 连接 。Web ADF 的 功 
能 接口 如 表 5-2 所 示 。 


表 5-2 Web ADF 中 的 功能 接口 及 其 描述 


功能 接口 说 明 
地 图 资源 IMapFunctionality 绘制 地 图 
IQueryFunctionality 空间 与 属性 查询 
IMapTocFunctionality 73 Toc 控件 提供 信息 
ITileFunctionality 通过 事先 生成 的 地 图 切片 提供 地 图 数据 
IScalebarFunctionality 为 地 图 比例 尺 提 供 信息 
地 理 编 码 资源 ， IGeocodeFunctionaltiy 支持 地 址 匹配 


空间 处 理 资源 ^^ IGeoprocessingFunctionality 支持 空间 处 理 操作 
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为 了 在 Web ADF 中 使 用 自 定义 的 数据 源 ， 就 必须 实现 数据 源 接口 、 资 源 接口 与 功能 接口 。 除 了 
这 些 接口 外 ，Web ADF 还 提供 了 一 组 使 用 数据 源 的 类 库 ， 这 些 数据 源 包 括 ArcGIS Server, ArcIMS, 
ArcWeb, OGC\WMS 与 Web ADF 图 形 。 图 5.3 描述 了 公有 API 抽象 框架 、 一 组 ArcGIS Server 与 
ArcGIS 的 实现 ， 以 及 Web ADF 控件 与 地 图 资源 管理 器 是 如 何 通过 公有 APT 访问 数据 源 的 。 


Web ADF Controis 


Generic 


implementation E ETS 


图 5.3 公有 API 的 内 容 及 其 相互 关系 


一 些 数据 源 ， 例 如 ArcGIS Server 与 ArcIMS， 除 了 使 用 上 述 公 有 API 之 外 ， 为 了 能 更 细 粒 度 
地 访问 数据 源 ， 还 有 专 有 API。 表 5-3 列 出 了 数据 源 类 型 及 其 对 应 的 公用 API 实现 类 库 以 及 专 有 
API 类 库 。 


表 5-3 数据 源 类 型 及 其 对 应 的 公有 API、 专 有 API 类 库 


数据 源 公有 API 类 库 tA AP 类 库 
ArcGIS ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.dll ^ ESRI.ArcGIS.ADF.ArcGISServer.dll 
ArcIMS ESRIArcGIS.ADF.Web.DataSources.IMS.dll ESRI.ArcGIS.ADF.IMS.dll 
ArcWeb ESRLArcGIS.ADF.Web.DataSources.Arc WebService.dll ESRLArcGIS.ADF.ArcWebService.dll 
OGCWMS . ESRLArcGIS.ADF.Web.DataSources.OGCWMSService 无 

.dll 


Web ESRLArcGIS.ADF.Web.DataSources.Graphics.dll ESRLArcGIS.ADF.Web.dll 
公有 API 的 一 个 最 大 优势 是 可 以 同时 处 理 不 同 的 数据 源 ， 通 过 其 中 的 接口 我 们 可 以 不 理会 具 
体 使 用 什么 方式 访问 数据 源 的 , 也 不 需要 了 解数 据 源 是 ArcIMS, ArcGIS Server 还 是 ArcWeb 服务 ， 
而 直接 使 用 资源 与 功能 即 可 。 


522 ”公有 数据 源 API 的 实现 


下 面 我 们 通过 本 地 连接 ArcGIS Server 数据 源 来 介绍 公有 API 的 实现 。 
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如 图 5.4 所 示 ，IGISDataSource 接口 定义 与 特定 数据 源 的 连接 ， 以 及 连接 时 使 用 的 身份 以 及 连 
接 状态 .实现 该 接口 的 数据 源 需 要 提供 访问 数据 源 的 连接 对 象 与 参数 在 图 $.4 中 ,在 ArcGIS Server 
API 中 的 对 象 也 实现 了 公有 API 中 的 IGISDataSource 接口 。 虽 然 两 个 实现 都 维护 公用 的 属性 ， 例 
如 身份 与 状态 信息 ， 但 是 依据 数据 源 类 型 ， 它 们 定义 不 同 连接 属性 。ArcGIS Server 本 地 连接 要 求 
使 用 连接 库 CESRLArcGIS.ADF.dll 与 ESRLArcGIS.ADF.Connection.dll) ， 而 ArcGIS Server 远程 
数据 源 不 需要 连接 库 ， 只 要 一 个 表示 Web 服务 端点 的 URL。 因 此 就 创建 了 使 用 本 地 连接 的 特定 的 
IGISDataSource， 即 GISDataSouceLocal。 


D 
EJ ArcGIS Server APIs 


图 5.4 GlSDataSourceLocal 的 创建 


IIGISDataSource 


通常 ， 数 据 源 决定 了 资源 类 型 。 每 个 数据 源 可 以 有 多 个 资源 。IGISResource 是 资源 的 最 顶层 的 
接口 ， 是 IMapResource 与 IGeocodeResource 两 个 常用 的 资源 接口 。IMapResource 代表 数据 源 可 为 
地 图 提供 空间 数据 、 绘 制 地 图 以 及 查询 。IGeocodeResource 代表 数据 源 可 用 于 地 址 匹配 。 

如 图 5.5 所 示 ，ArcGIS Server 实现 了 创建 MapResouce 与 GeocodeResource 的 接口 。 由 于 是 
ArcGIS Server 本 地 数据 源 ， 该 MapResource 接口 同时 提供 访问 地 图 服务 器 对 象 与 服务 器 上 下 文 。 
同样 ，GeocodeResource 也 提供 了 访问 地 址 匹配 服务 器 对 象 与 服务 器 上 下 文 。 


IGISesource 


IMapResource 


ArcGISServer . MapResourceLocal 


. GISDataSourceLocal - MapServer 
- Resources - ServerContextInfo 


图 5.5 ArcGIS Server 本 地 数据 源 的 资源 


每 个 资源 又 可 以 有 多 个 功能 。 如 果 一 个 资源 支持 某 功能 ， 那 么 该 资源 就 能 创建 该 功能 ， 然 后 利 
用 该 功能 执行 操作 。IGISFunctionality 是 功能 中 最 顶层 的 接口 ， 是 IMapFunctionality 与 
IQueryFunctionality 两 常用 的 功能 接口 。 由 MapResource 来 创建 这 两 功能 。IMapFunctionality 表示 
资源 的 绘图 能 力 ， 例 如 生成 地 图 图 片 、 设 置 或 得 到 显示 范围 以 及 改变 图 层 的 可 见 性 等 。 
IQueryFunctionality 表示 资源 的 空间 与 属性 查询 能 力 ， 例 如 使 用 一 个 where 语句 以 及 图 形 来 返回 要 
素 的 几何 图 形 与 属性 。 
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如 图 5.6 所 示 ，ArcGIS Server 实现 了 创建 MapFunctionality Ej QueryFunctionality 的 接口 。 虽 然 
MapDescription 对 象 专属 于 ArcGIS Server 实现 IMapFunctionality 的 类 ， 不 过 功能 的 大 多 数 方法 与 
属性 都 可 以 通过 上 层 抽象 接口 来 调用 。 
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IGISFunctionality 

IMapFunctionality 

- Extent 

- SetGetLayerVisibility() 
IGISResource ArcGISServer 
- Functionalities MapFunctionality 
- CreateFunctionalty() . MapDescription 

MapResourceLocal QueryFonctionality 
- Query) 
- Identify() 


ArcGISServer 
QueryFunctionality 


图 5.6 ArcGIS Server 本 地 地 图 资源 的 功能 


5.3 ArcGIS Server 数据 源 的 使 用 


在 5.1 节 中 我 们 泛泛 地 介绍 了 Web ADF 自身 提供 的 类 库 可 以 访问 的 数据 源 类 型 ， 但 是 并 没有 
深入 介绍 每 个 数据 源 使 用 的 方式 。 通 常 ， 使 用 最 广泛 的 是 ArcGIS Server 数据 源 ， 因 此 有 必要 深入 
介绍 下 ArcGIS Server 数据 源 的 使 用 。 


ArcGIS Server API 


程序 员 可 以 通过 两 类 API 来 访问 与 操作 ArcGIS Server 服务 , 分 别 是 ArcGIS Server ArcObjects 
API 与 ArcGIS Server SOAP API。 

ArcObjects API 使 用 客户 端的 ArcObjects 互 操作 程序 集 与 对 象 库 和 GIS 服务 中 的 ArcObjects 
打交道 , 因此 只 有 直接 通过 SOM 访问 ArcGIS 服务 器 时 才能 使 用 该 方式 。 该 API 包含 了 ArcObjects 
类 库 才 能 提供 的 深入 的 实用 功能 。 

SOAP API 是 与 基于 SOAP 标准 的 ArcGIS Server 服务 通信 的 XML 结构 的 语言 .服务 器 对 象 以 
及 一 些 服务 器 扩展 对 象 定义 了 一 组 SOAP 标签 与 属性 ， 用 于 处 理 SOAP 请 求 与 生成 SOAP 响应 。 


由 于 该 功能 在 服务 器 对 象 层 


ij 上， 开发 人 员 可 以 直接 使 用 SOAP， 而 不 需要 使 用 Web 服务 ， 便 可 


与 服务 器 对 象 交互 。ArcGIS Server 的 Web 服务 通过 Web 服务 端点 对 外 提供 该 功能 ， 但 是 SOAP 
接 由 服务 器 对 象 或 扩展 对 象 处 理 。 使 用 SOAP API 最 简单 的 方法 是 在 开发 环境 中 
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使 用 SOAP 工具 包 生 成 代理 类 。 一 般 不 直接 操作 SOAP 字符 串 ， 而 是 使 用 本 地 代理 类 与 值 对 象 ， 
通过 Web 服务 端点 或 SOM， 与 ArcGIS Server 服务 交互 。SOAP API 只 能 保持 很 有 限 的 状态 信息 ， 
因此 需要 客户 端 应 用 程序 负责 维护 状态 。 


5.3.2 Web ADF 中 的 ArcGIS Server API 


Web ADF 中 实现 与 ArcGIS Server 交互 的 类 包含 在 两 个 类 库 中 ， 分 别 是 
ESRLArcGIS.ADF.ArcGISServer.dll 与 ESRI.ArcGIS.ADF.Web.DataSouce.ArcGISServer.dll。 后 者 包 
A T ArcGIS Server 本 地 与 远程 数据 源 的 公有 API 的 实现 类 。ArcGIS Server 本 地 数据 源 直接 连接 
SOM 以 及 直接 与 服务 器 对 象 交互 。ArcGIS Server 远程 数据 源 连 接 的 是 ArcGIS Server Web 服务 端 
Fio TE Web ADF 中 ， 两 者 都 使 用 ArcGIS Server SOAP API 来 实现 。 

许多 基础 类 ， 例 如 MapResourceBase、GISDataSourceBase， 为 这 两 种 ArcGIS Server 数据 源 定 
义 了 共享 的 成 员 ， 但 是 这 两 不 同 的 数据 源 使 用 不 同 的 实现 类 与 代理 类 连接 ArcGIS Server 服务 ， 如 
图 5.7 所 示 。 此 外 ， 就 如 同 ADF 9.0/9.1 的 方式 ，ArcGIS Server 本 地 数据 源 能 与 服务 器 上 下 文 交 互 ， 
并 能 通过 客户 端的 ArcObjects COM 代理 类 ， 创 建 服务 器 上 的 对 象 。 


! MapResourceBase 
- MapServerProxy 


ArcGIS Server Internet 


ELT 
Web Service — | ArcGIS 
Server 


ArcGIS Server Local 


图 5.7 不 同 数据 源 使 用 不 同 的 实现 类 与 代理 类 连接 


通过 ESRI ArcaIS ADF ARC GISServer.dll 程序 集中 的 值 对 象 与 代理 数 ， 可 使 用 ArcalS 
ServerSoAP API。 两 种 数据 源 共用 基于 无 状态 的 值 对 象 ,但 使 用 不 同 的 代理 类 与 服务 器 交互 。 ArcGIS 
Server 本 地 数据 源 利用 DCOM 代理 (例如 MapServerDcomProxy) ， 直 接 与 服务 器 对 象 通讯 。 而 
ArcGIS Server 远程 数据 源 基于 Web 服务 代理 (例如 MapServerProxy) ， 与 Web 服务 端口 通讯 。 

值 对 象 存储 在 客户 端 ， 依 赖 于 客户 端的 环境 。 代 理 对 象 也 存储 在 客户 端 ， 它 负责 与 服务 器 端 
远程 对 象 的 通讯 。 根 据 需要 , 代理 对 象 根据 远程 对 象 的 要 求 序列 化 本 地 值 对 象 , 然后 传递 到 服务 端 ; 
对 于 服务 端 远程 对 象 的 结果 反 序 列 化 ， 并 在 本 地 创建 值 对 象 ， 过 程 如 图 5.8 所 示 。 
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Client Application 


图 5.8 代理 对 象 的 序列 化 与 反 序列 化 


Web 服务 工具 使 用 WSDL 文档 ,生成 本 地 值 对 象 和 Web 服务 的 代理 对 象 ,在 Visual Stuido 2005 
以 及 .NET 开发 包 中 的 wsdl.exe 就 是 这 样 一 个 工具 。 

每 类 ArcGIS Server 服务 都 维护 一 个 单独 的 WSDL 文档 , 该 文档 描述 了 如 何 通过 SOAP 与 服务 
交互 。Web 服务 代理 只 用 于 以 无 状态 方式 与 ArcGIS Server Web 服务 交互 。 因 此 需要 开发 人 员 在 客 
户 端 管理 状态 。 在 客户 端 ，ArcGIS Server Web 服务 的 代理 类 负责 SOAP 的 序列 化 与 反 序列 化 。 在 
服务 端 , ArcGIS Server Web 服务 管理 服务 器 的 上 下 文 。 对 于 Web 服务 , 所 有 的 通信 都 是 无 状态 的 ， 
当 处 理 HTTP 请 求 时 ， 创 建 服务 器 上 下 文 ， 当 响应 发 送 给 客户 端 时 则 销毁 上 下 文 。 

如 图 5.9 所 示 ， 尽 管 ArcGIS Server 服务 器 对 象 可 使 用 值 对 象 ， 但 是 由 于 需要 COM 代理 ， 因 
此 通信 要 相对 复杂 。WSDL 没有 规定 DCOM 代理 直接 与 服务 器 对 象 交 互 ， 因 此 需要 开发 人 员 管 理 
通信 过 程 。 如 果 服 务 器 对 象 实现 了 IFequestHandler 接口 ， 使 用 HandleStringRequest 方法 来 发 送 与 
获取 SOAP 请 求 与 响应 。 也 需要 由 开发 人 员 负 责 初始 化 连接 并 序列 化 与 反 序列 化 SOAP。 如 果 使 用 
了 值 对 象 ， 也 需要 负责 它们 的 序列 化 与 反 序列 化 。 不 过 Web ADF 提供 了 一 DCOM 代理 与 一 组 相 
关 的 类 帮助 开发 人 员 实现 上 述 功能 。 


ArcGIS Server 
Client Application 


图 5.9 ArcGIS Server 代理 类 与 数据 源 的 连接 


如 图 5.10 所 示 ，ArcGIS Server 本 地 数据 源 使 用 DCOM 代理 将 值 对 象 序列 化 为 SOAP, 并 通过 
IRequestHandler 接口 与 服务 器 对 象 交 互 。 也 就 是 基于 DCOM 的 SOAP。 例 如 ， 在 Web ADF 的 地 
图 控件 中 ， 如 果 是 使 用 ArcGIS Server 本 地 数据 源 ， MapResourceLocal 实例 使 用 
MapServerDcomProxy 类 通过 SOAP 与 服务 器 对 象 通信 。 而 ArcGIS Server 远程 数据 源 使 用 Web 服 
务 代理 将 值 对 象 序列 化 为 SOAP, 并 通过 HTTP 与 Web 服务 端点 交互 。 也 就 是 基于 HTTP 的 SOAP. 
例如 ， 使 用 ArcGIS Server 远程 数据 源 的 地 图 控件 ，MapResouceInternet 实例 使 用 MapServerProxy 
类 通过 SOAP 与 Web 服务 通信 。 
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图 5.10 Web ADF 中 值 对 象 与 代理 类 的 使 用 


每 个 地 图 控件 创建 一 个 MapFunctionality 对 象 与 客户 端的 值 对 象 MapDescription 交互 。 


MapFunctionality 使 用 该 MapDescription 与 ArcGIS Server 地 图 服务 器 对 象 的 绘图 功能 打交道 , 例如 
生成 一 张 新 地 图 图 片 。MapFunctionality 对 象 的 MapDescription 属性 存储 了 地 图 控件 的 状态 ， 而 
MapResourceLocal 对 象 的 MapDescription 属性 存储 了 资源 的 状态 ， 该 值 可 以 被 使 用 该 资源 的 任何 
功能 共享 。 但 默认 时 ， 每 个 MapFunctionality 使 用 自己 的 MapDescription 来 维护 状态 。 不 管 是 哪 种 
情况 ，MapResourceLocal 对 象 使 用 MapServerDcomProxy 类 创建 服务 器 上 下 文 ， 并 管理 与 地 图 服务 
器 对 象 的 无 状态 的 交互 。MapResourceLocal 同时 也 提供 了 访问 服务 器 上 的 细 粒 度 的 ArcObjects。 可 
通过 MapServer 属性 服务 MapServer 对 象 ， 通 过 ServerContextInfo 类 可 访问 服务 器 上 下 文 。 


5.3.3 ”管理 服务 器 上 下 文 


当 使 用 ArcGIS Server 本 地 数据 源 时 ， 可 通过 服务 器 上 下 文 直接 与 服务 器 对 象 交 互 。 服 务 可 以 


发 布 为 池 化 也 可 为 非 池 化 。 当 在 地 图 资源 管理 器 中 , 将 ArcGIS Server 服务 器 对 象 作为 资源 使 用 时 ， 
地 图 资源 管理 器 创建 与 管理 服务 器 上 下 文 。 对 于 池 化 的 服务 器 对 象 , 并 不 需要 开发 人 员 编 写 代码 释 
放 服 务 器 上 下 文 ， 而 是 由 Web ADF 来 释放 。 但 是 对 于 非 池 化 的 服务 器 对 象 ， 需 要 通过 代码 释放 。 
在 服务 器 上 下 文 释放 之 前 ， 表 示 服 务 器 对 象 实例 仍然 在 使 用 ， 其 他 客户 不 能 使 用 。 


下 面 我 们 通过 一 个 实例 演示 如 何 获取 服务 器 上 下 文 的 。 在 Visual Studio 2005 中 ， 利 用 File 菜 


单 的 New Web Site 命令 ， 创 建 一 个 新 的 Web 站 点 ， 命 名 为 ContextManager。 为 了 演示 如 何 使 用 
ArcGIS Server ArcObjects API， 本 实例 不 使 用 任何 Web ADF 控件 。 这 就 要 求 我 们 手工 加 入 如 下 
ArcGIS 引用 (通过 工程 的 右键 菜单 的 Add ArcGIS Reference 命令 ) : ESRIArcGIS.Server、 
ESRI.ArcGIS.ADF.Connection、 ESRI.ArcGIS.Carto, ESRI.ArcGIS.ADF, ESRI.ArcGIS.Geodatabase、 
ESRI.ArcGIS.Display 与 ESRLArcGIS.Geometry 


在 Default.aspx 中 加 入 一 个 Image 控件 ， 将 其 ID 设置 为 imgOutput。 
切换 到 Default.aspx.cs 文件 中 ， 在 头 部 加 入 如 下 命名 空间 的 引用 : 
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Using ESRI.ArcGIS.ADF 

using ESRI.ArcGIS.Server; 

using ESRI.ArcGIS.Carto; 

using ESRI.ArcGIS.ADF.Connection.AGS; 
using ESRI.ArcGIS.Geodatabase; 

using ESRI.ArcGIS.Display; 


首先 加 入 如 下 代码 ， 以 获取 服务 器 上 下 文 对 象 : 


private IServerContext getServerContext() { 
string servername - "localhost"; 
string mapserverobject - "USAMap"; 
IServerObjectManager serverManager; 


if (Session["SOM"] —- null) ( 
// *** 使 用 Web ADF 公有 API 


Identity identity = new Identity("Administrator", "1", null); 


AGSServerConnection gisconnection = 
new AGSServerConnection (servername, 
identity); 

gisconnection.Connect () ; 


serverManager - gisconnection.ServerObjectManager; 
Session.Add("SOM", serverManager); 


) 
else ( 

serverManager = Session["SOM"] as IServerObjectManager; 
) 


IServerContext mapContext = 


serverManager.CreateServerContext (mapserverobject, "MapServer"); 


return mapContext; 


) 


要 得 到 服务 器 上 下 文 对 象 ， 就 必须 先 建立 与 服务 器 的 连接 。 可 以 使 用 AGSServerConnection 类 
来 建立 连接 ， 在 构造 该 类 的 对 象 时 ， 第 一 个 参数 是 服务 器 的 计算 机 名 或 IP 地 址 ， 第 二 个 参数 是 一 
个 Identity 对象， 用 于 身份 验证 。Identity 类 构造 函数 的 第 一 个 参数 是 用 户 名 ， 第 二 个 参数 是 口令 ， 


第 三 个 参数 是 域名 ， 一 般 可 以 不 提供 。 


在 构造 好 连接 对 象 后 ， 调 用 其 Connect 方法 进行 连接 。 连 接 成 功 后 通过 连接 对 象 的 
ServerObjectManager 属性 找到 GIS 服务 器 上 的 SOM. 然后 通过 SOM 创建 一 个 服务 器 上 下 文 对 象 。 


服务 器 上 下 文本 质 上 是 一 个 GIS 服务 器 上 的 进程 ， 它 也 是 服务 器 端 编程 的 起 点 。 


因此 ， 我 们 


是 通过 CreateServerContext 命令 在 服务 器 端 上 创建 ， 而 不 使 用 new 关键 字 在 本 机 上 创建 。 


加 入 页 面 PreRender 事件 处 理 代码 ， 如 下 所 示 : 


protected void Page PreRender(object sender, EventArgs e) { 
if (Page.IsPostBack) 
return; 


// 得 到 服务 器 上 下 文 对 象 
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IServerContext mapContext = getServerContext (); 
IMapServer mapServer = mapContext.ServerObject as IMapServer; 


IMapServerInfo mapInfo = 
mapServer.GetServerInfo (mapServer.DefaultMapName); 
IMapDescription mapDesc - mapInfo.DefaultMapDescription; 


CreateMapImage (mapContext, mapDesc); 


mapContext.ReleaseContext () ; 


} 


在 上 面 的 代码 中 ， 首 先是 调用 getServerContext 方法 ， 得 到 服务 器 上 下 文 对 象 ， 然 后 从 上 下 文 
对 象 找到 服务 器 对 象 ， 从 服务 器 对 象 中 得 到 服务 器 地 图 信息 对 象 ， 该 对 象 的 DefaultMapDescription 
属性 维护 着 地 图 描述 信息 。 然 后 调用 自 定义 方法 CreateMapImage 得 到 地 图 ， 最 后 调用 


ReleaseContext 方法 释放 上 下 文 对 象 。 
定义 CreateMapImage 方法 的 代码 如 下 : 


private void CreateMapImage (IServerContext mapContext, IMapDescription 
d 

IImageType imageType; 

IImageDescription imageDesc; 

IImageDisplay imageDisp; 


mapContext.CreateObject ("esriCarto.ImageType") 
as IImageType; 

imageDesc - mapContext.CreateObject ("esriCarto.ImageDescription") 
as ImageDescription; 

mapContext.CreateObject ("esriCarto.ImageDisplay") 
as ImageDisplay; 


imageType 


imageDisp 


imageType.Format = esrilmageFormat.esrilmageJPG; 
imageType.ReturnType = esrilmageReturnType.esrilmageReturnURL; 


imageDisp.Height = (int)imgOutput.Height.Value; 
imageDisp.Width = (int)imgOutput.Width.Value; 
imageDisp.DeviceResolution - 96; 


imageDesc.Display = imageDisp; 
imageDesc.Type = imageType; 


IMapServer mapServer = (IMapServer)mapContext.ServerObject; 


IImageResult mapImage = mapServer.ExportMapImage (md, imageDesc); 
imgOutput.ImageUrl = maplmage.URL; 
imgOutput.Visible = true; 

) 


在 上 述 代 码 中 , 通过 上 下 文 对 象 的 CreateObject 方法 创建 了 几 个 与 绘图 相关 的 对 象 。 这 是 
别 注意 的 是 ， 由 于 我 们 是 要 在 远程 的 GIS 服务 器 上 创建 对 象 ， 而 不 是 在 本 应 用 程序 的 进程 
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对 象 ， 所 以 不 能 使 用 new 关键 字 ， 而 必须 使 用 上 下 文 对 象 的 CreateObject 方法 来 创建 。 
在 创建 好 绘图 需要 的 相关 对 象 后 , 设置 恰当 的 属性 值 , 最 后 调用 服务 器 对 象 的 ExportMapImage 
方法 输出 地 图 图 片 。 
编译 并 运行 程序 ， 程 序 运行 效果 如 图 5.11 所 示 。 


fs 
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图 5.11 利用 服务 器 上 下 文 得 到 地 图 


下 面 再 演示 如 何 通过 程序 动态 地 增加 图 层 数 据 。 在 Default.aspx.cs 页 面 文件 中 增加 如 下 方法 ， 
实现 增加 图 层 : 


private void AddTheLayers (IServerContext in mapcontext) 
t 
IFeatureLayer layer = (IFeatureLayer)in mapcontext.CreateObject ( 
"esriCarto.FeatureLayer"); 


IWorkspaceFactory factory = 
(IWorkspaceFactory)in mapcontext.CreateObject( 
"esriDataSourcesFile.ShapefileWorkspaceFactory"); 


string filepath = 8"C:XProgramFilesVArcGISMDeveloperKitV 
SamplesNETNServerNdataWNorthAmerica"; 

string filename - "canada.shp"; 

IWorkspace ws = factory.OpenFromFile(filepath, 0); 

IFeatureWorkspace fws = (IFeatureWorkspace)ws; 

layer.FeatureClass = fws.OpenFeatureClass (filename); 

layer.Name = "canada"; 


) 
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IGeoFeatureLayer iglayer = (IGeoFeatureLayer)layer; 
IFeatureRenderer renderer - iglayer.Renderer; 


ISimpleRenderer isr = (ISimpleRenderer)renderer; 
IRgbColor irgbc = 
(IRgbColor)in mapcontext.CreateObject ("esriDisplay.RgbColor"); 
irgbc.Red - 0; 
irgbc.Green - 0; 
irgbc.Blue - 210; 


ESRI.ArcGIS.Geometry.esriGeometryType featype - 
layer.FeatureClass.ShapeType; 

if (featype == ESRI.ArcGIS.Geometry.esriGeometryType.esriGeometryPoint) 

{ 
ISimpleMarkerSymbol ifs = (ISimpleMarkerSymbol)isr.Symbol; 
ifs.Color = (IColor)irgbc; 

) 

else if ( 

featype == ESRI.ArcGIS.Geometry.esriGeometryType.esriGeometryPolyline)( 
ISimpleLineSymbol ifs - (ISimpleLineSymbol)isr.Symbol; 
ifs.Color - (IColor)irgbc; 

) 

else if ( 

featype == ESRI.ArcGIS.Geometry.esriGeometryType.esriGeometryPolygon)( 
ISimpleFillSymbol ifs = (ISimpleFillSymbol)isr.Symbol; 
ifs.Color - (IColor)irgbc; 

) 

else ( 


throw new Exception (" 图 层 类 型 不 确定 ! "); 
IMapServer ms = (IMapServer)in mapcontext.ServerObject; 
IMapServerObjects2 mso - (IMapServerObjects2)ms; 
string mapname = ms.DefaultMapName; 


IMap map - mso.get Map (mapname); 


map.AddLayer (layer); 
mso.RefreshServerObjects(); 


上 述 代 码 中 ， 首 先 利 用 服务 器 上 下 文 对 象 ， 创 建 要 素 图 层 对 象 与 工作 空间 工厂 对 象 ， 然 后 利 
用 此 工厂 对 象 打 开 一 文件 夹 ， 作 为 工作 空间 对 象 。 利 用 此 工作 空间 对 象 的 OpenFeatureClass 方法 
将 文件 夹 中 指定 文件 名 的 要 素 图 层 打开 。 接 着 指定 着 色 器 对 象 。 最 后 将 图 层 增加 到 地 图 中 ,完成 动 
态 增 加 图 层 。 

然后 在 Default.aspx 页 面 中 增加 一 个 按钮 控件 ，ID 设置 为 AddLayer。 双 击 该 控件 ， 生 成 控件 
的 OnClick 事件 处 理 方法 ， 在 其 中 加 入 如 下 代码 : 
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protected void AddLayer Click(object sender, EventArgs e) { 


// 得 到 服务 器 上 下 文 对 象 


IServerContext mapContext = this.getServerContext () ; 


// 增加 图 层 
AddTheLayers (mapContext) ; 


// 从 上 下 文 对 象 中 得 到 服务 器 对 象 

IMapServer ms = (IMapServer)mapContext.ServerObject; 
IMapServerInfo mapInfo = ms.GetServerInfo (ms.DefaultMapName); 
IMapDescription NEWmapDesc - mapInfo.DefaultMapDescription; 


// 输出 地 图 
CreateMapImage (mapContext, NEWmapDesc); 


// 释放 服务 器 上 下 文 对 象 


mapContext .ReleaseContext (); 


} 

代码 很 简单 ， 首 先 得 到 服务 器 上 下 文 对 象 ， 然 后 加 入 图 层 ， 接 着 输出 一 张 地 图 ， 最 后 释放 对 象 。 

编译 并 运行 程序 ， 通 过 选择 “增加 图 层 ” 按 钮 ， 即 可 动态 增加 加 拿 大 图 层 数据 ， 所 得 结果 如 
图 5.12 所 示 。 
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图 5.12 动态 增加 图 层 


服务 器 上 下 文 对 象 除了 用 我 们 上 面 演示 的 CreateObject 方法 来 创建 对 象 之 外 ， 可 用 SetObject 
和 GetObject 方法 存储 与 获取 对 象 的 引用 。 每 个 服务 器 上 下 文 对 象 都 包含 一 个 字典 (存储 名 称 和 值 )， 
该 字典 是 一 个 用 来 在 上 下 文 对 象 内 保存 在 上 下 文 对象 内 创建 的 对 象 最 方便 的 地 方 。 只 要 上 下 文 对 象 
存在 ， 其 字典 中 存储 的 对 象 就 存在 ， 当 释放 上 下 文 对象 以 后 其 字典 也 就 不 存在 了 。 可 以 在 程序 的 不 
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同 地 方 通过 该 字典 来 共享 数据 。 例 如 : 


IPointCollection pPointCollection = 
pServerContext.CreateObject ("esriGeometry.Polygon") as IPointCollection; 


// 先 在 字典 中 存储 对 象 pPointCollection 
pServerContext.SetObject ("myPoly", pPointCollection); 
// 从 字典 中 获取 对 象 pPointCollection 

IPolygon pPoly = pServerContext.GetObject ("myPoly"); 


要 从 字典 中 删除 对 象 可 以 使 用 Remove 和 RemoveAll 方法 。 

SaveObject 和 LoadObject 方法 用 来 在 服务 器 上 下 文 对 象 之 间 共 享 数 据 ，SaveObject 把 某 个 上 
下 文 对 象 中 创建 的 对 象 序列 化 为 字符 串 , LoadObject 用 来 在 另 一 个 上 下 文 对 象 中 把 某 个 字符 串 反 序 
列 化 为 对 象 。 例 如 : 


IServerContext pServerContext = 

pSOM.CreateServerContext ("RedlandsMap", "MapServer"); 
IServerContext pServerContext2 = 

pSOM.CreateServerContext ("RedlandsGeocode", "GeocodeServer"); 
IGeocodeServer pGCServer = pServerContext2.ServerObject; 
IPropertySet pPropertySet - 

pServerContext2.CreateObject ("esriSystem.PropertySet"); 
pPropertySet.SetProperty("Street", ""); 
IPropertySet pResults = pGCServer.GeocodeAddress (pPropertySet, Nothing); 
IPoint pPoint = pResults.GetProperty ("Shape"); 


// {E pServerContext2 中 的 pPoint 对 象 序列 化 

string sPoint = pServerContext2.SaveObject (PPoint) ; 

/ /1£ pServerContext 中 把 sPoint 字符 串 反 序列 化 

IPoint pPointCopy = pServerContext.LoadObject (sPoint); 

总 之 ，SetObject 和 GetObject 是 在 同一 个 上 下 文 对 象 中 共享 数据 。SaveObject 和 LoadObject 
方法 是 在 多 个 上 下 文 对 象 之 间 共 享 数据 。 


5.4 ”操作 资源 与 功能 对 象 


资源 的 初始 化 与 管理 都 由 资源 管理 器 来 完成 。Web ADF 提供 了 三 个 资源 管理 器 ， 分 别 是 地 图 
资源 管理 器 、 地 理 编码 资源 管理 器 与 空间 处 理 资 源 管理 器 。 每 个 资源 管理 器 包含 一 个 资源 集合 。 


5.4.1 增加 与 删除 资源 


可 以 在 程序 设计 期 间 通过 Visual Studio 进行 ， 也 可 以 在 程序 运行 期 间 通过 代码 ， 加 入 资源 。 
第 4 章 已 经 介绍 了 如 何在 设计 期 间 加 入 资源 。 

要 通过 代码 加 入 资源 ， 首 先 需要 创建 资源 项 ， 然 后 设置 起 属性 ， 最 后 加 入 到 资源 管理 器 中 。 
下 面 通 过 一 个 实例 来 介绍 如 何 动态 管理 资源 管理 器 中 的 资源 项 。 
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在 Visual Studio 2005 中 ， 利 用 File 菜单 的 New Web Site 命令 ,创建 一 个 新 的 Web 站 点 ， 
名 为 DynamicAddResource。 
从 工具 箱 的 ArcGIS Web Controls 选项 卡 中 ， 在 Default.aspx 页 面 中 增加 一 个 地 图 资源 管理 


命 


器 


控件 、 一 个 地 图 控件 以 及 一 个 Toc 控件 。 在 地 图 资源 控件 中 加 入 NorthAmericaMap 资源 。 并 通过 


工程 右键 菜单 的 Add ArcGIS Identity 命令 加 入 身份 验证 信息 。 


再 从 工具 箱 的 Standard 选项 卡 中 , 加 入 一 CheckboxList 控件 ,通过 其 Items 属性 , 在 其 中 加 入 


两 项 ， 分 别 为 将 其 Text 属性 设置 为 “ArcGIS Server 本 地 资源 ”与 “ArcGIS Server 远程 资源 ”。 
在 Default.aspx.cs 文件 的 头 部 加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF; 

using ESRI.ArcGIS.ADF.Web; 

using System.IO; 


为 使 用 回调 机 制 ， 需 要 Default 类 实现 ICallbackEventHandler 接口 。 
fE Default 类 中 加 入 如 下 字段 : 


public string addRemoveResource; 

private string resourceName = string.Empty; // 选中 的 资源 名 称 
private string callbackResponse = ""; // 回调 返回 的 字符 串 
const string AGSLocalName = "LocalMapResource"; 

const string AGSInternetName = "InternetMapResource"; 


在 Page OnLoad 方法 中 加 入 如 下 代码 : 


protected void Page Load(object sender, EventArgs e) ( 
foreach (ListlItem li in CheckBoxListl.Items) { 
li.Attributes.Add("onclick", "ChangeCheckContext (this)"); 
) 


addRemoveResource = ClientScript.GetCallbackEventReference (this, 


"message", "processCallbackResult", "context", "postBackError", true); 


) 


通过 上 面 的 代码 ， 指 定 了 复 选 框 的 onclick 事件 的 处 理 函数 为 ChangeCheckContext. 
切换 到 Defaultaspx 中 ， 在 其 <head> 与 </head> 之 间 加 入 ChangeCheckContext 函数 的 代码 ， 


<script language="javascript" type="text/javascript"> 
function ChangeCheckContext (checkbox) { 

var val = checkbox.nextSibling.innerText; 

var ischecked = checkbox.checked; 

context = "cb"; 

var message = "changeresource,"; 


message += val + ',' + ischecked; 


<%= addRemoveResource$» 


b 
</script> 


代 
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f£ Default 类 中 加 入 如 下 实现 ICallbackEventHandler 接口 的 代码 : 


string ICallbackEventHandler.GetCallbackResult() { 
return callbackResponse; 


void ICallbackEventHandler.RaiseCallbackEvent (string eventArgs) { 
char[] charToParse = { ',' }; 
string[] messages - eventArgs.Split (charToParse); 
if (eventArgs.Contains ("changeresource")) ( 
string dataSourceType = messages[1]; 
bool isChecked = Boolean.Parse (messages[2]); 
switch (dataSourceType) ( 
case "ArcGIS Server 本 地 资源 " : 
resourceName = AGSLocalName; 
break; 
case "ArcGIS Server 远程 资源 ": 
resourceName = AGSInternetName; 
break; 
default: 
break; 


MapResourceChange (isChecked); 


) 

在 进行 回调 处 理 时 ， 代 码 主要 集中 在 RaiseCallbackEvent 方法 。 在 该 方法 中 先 判断 用 户 选 择 的 
是 哪个 复 选 框 ， 并 判断 是 选择 还 是 去 除 选择 ， 最 后 调用 MapResourceChange 方法 实现 资源 的 动态 
增加 与 删除 。 该 方法 的 代码 如 下 : 


private void MapResourceChange (bool isChecked) 
{ 
GISResourceItemCollection<MapResourceItem> mapResourceItemCollection = 
MapResourceManagerl.ResourceItems; 
MapResourcelItem mapResourceItem = null; 


// 如 果 选 中 ， 则 增加 资源 ， 否 则 ， 删 除 资源 

if (!isChecked) { 
mapResourceItem = mapResourceItemCollection.Find (resourceName); 
mapResourceItemCollection.Remove (mapResourceItem); 

) 

else ( 
mapResourceltem = new MapResourceItem(); 


// 地 图 资源 项 由 一 定义 与 显示 设置 组 成 

// 定义 规定 了 数据 源 与 资源 参数 

// 显示 设置 规定 了 地 图 图 片 的 属性 

GISResourceItemDefinition definition = 
new GISResourceItemDefinition(); 
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switch (resourceName) { 
case (AGSLocalName): 
mapResourcelItem.Name = AGSLocalName; 


definition.DataSourceDefinition = "localhost"; 
definition.DataSourceType - "ArcGIS Server Local"; 
definition.ResourceDefinition = "Layers8USAMap"; 
break; 


case (AGSInternetName): 
mapResourceltem.Name = AGSInternetName; 
definition.DataSourceDefinition = 
"http://localhost/arcgis/services/"; 
definition.DataSourceType - "ArcGIS Server Internet"; 


Identity id = new Identity("Administrator", "1", ""); 
definition.Identity = id.ToString(); 
definition.ResourceDefinition = " (default) (9USAMap"; 
break; 


definition.DataSourceShared - true; 
mapResourceItem.Parent = MapResourceManagerl; 
mapResourceItem.Definition = definition; 


DisplaySettings displaySettings - new DisplaySettings(); 
displaySettings.Transparency = 50.0F; 
displaySettings.Visible = true; 
displaySettings.ImageDescriptor.TransparentColor = 
System.Drawing.Color.White; 
displaySettings.ImageDescriptor.TransparentBackground - true; 
mapResourceItem.DisplaySettings - displaySettings; 
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// 将 新 资源 项 插入 到 开始 位 置 ， 即 最 上 面 

MapResourceManagerl.Resourceltems.Insert(0, mapResourceItem); 

// 创建 该 地 图 资源 

ESRI.ArcGIS.ADF.Web.DataSources.IMapResource mapResource = 
MapResourceManagerl.CreateResource (mapResourceItem); 


// 依据 融合 位 置 不 同 ， 刷 新 地 图 或 资源 

if (Mapl.ImageBlendingMode == ImageBlendingMode.WebTier) ( 
Mapl.Refresh(); 

) 

else ( 
Mapl.RefreshResource (mapResourcelItem.Name); 


// 刷新 Toc 控件 ， 并 将 回调 信息 加 入 到 地 图 控件 的 回调 集合 中 
Tocl.Refresh(); 
CallbackResult tocCallbackResult = RefreshControlHtml (Toc1); 
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Map1.CallbackResults.Add(tocCallbackResult) ; 


// 将 地 图 控件 的 回调 集合 转换 为 字符 串 
callbackResponse = Mapl.CallbackResults.ToString(); 
i 
在 上 述 代码 中 ， 对 于 移 除 某 一 个 资源 ， 代 码 很 简单 ， 只 需要 从 地 图 资源 管理 器 对 象 的 
Resourceltems 属性 中 删除 即 可 。 对 于 新 增加 资源 ， 则 新 构造 一 个 MapResourceltem 对 象 ， 然 后 设 
置 该 对 象 的 Definition 与 DisplaySetting 属性 ， 再 将 该 对 象 插入 到 地 图 资源 管理 器 对 象 的 
Resourceltems 属性 中 。 接 着 调用 地 图 资源 管理 器 对 象 的 CreateResource 方法 创建 新 加 入 的 地 图 资 
源 。 最 后 刷新 地 图 与 Toc 控件 ， 并 返回 客户 端 更 新 信息 。 
在 上 述 方法 中 调用 了 RefreshControlHtml 方法 ， 用 于 将 某 控件 的 刷新 转换 为 HTML 语句 ， 代 
人 码 如 下 : 


private CallbackResult RefreshControlHtml (Control control) 
t 


StringWriter stringWriter = new StringWriter(); 
HtmlTextWriter writer = new HtmlTextWriter(stringWriter); 
control.RenderControl (writer); 

string htmlContent = stringWriter.ToString():; 
stringWriter.Close(); 

return new CallbackResult (control, "content", htmlContent); 


} 
编译 并 运行 程序 ， 通 过 复 选 框 便 可 动态 地 加 入 或 删除 地 图 资源 了 ， 效 果 如 图 5.13 所 示 。 


F Untitled Page — Microsoft Internet Explorer 
XFO REO SEV KEA IAW 帮助 0D 
地 址 qo. IST / 'Aocalhost/Dynani chddResour ce/Default. aspx 


* [z LocalMapR.esource 
* [z NorthAmericaMap 


I ArcGIS Server 本 地 资源 
口 ArcGIS Server 远 程 资源 


图 5.13 动态 管理 地 图 资源 
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542 ”管理 地 图 资源 


地 图 资源 代表 可 访问 地 图 数据 ， 这 些 地 图 数据 包括 地 图 图 片 (动态 的 与 静态 的 ) 、 要 素 符号 
与 着 色 器 、 以 及 要 素 的 属性 。IMapResource 接口 中 定义 了 抽象 的 属性 存储 显示 设置 与 地 图 信息 。 

在 Web ADF 中 ， 管 理 地 图 资源 的 是 MapResourceManager 控件 ， 即 前 面 经 常用 到 的 地 图 资源 
管理 器 。 该 资源 可 创建 IMapFunctionality ~ IQueryFunctionality ~ IMapTocFunctionality ~ 
ITileFunctionality 与 IScaleBarFunctionality 功能 ， 分 别 代表 绘图 、 查 询 、 在 Toc 中 显示 、 地 图 切片 
以 及 显示 比例 功能 。 

K 5-4 列 出 了 IMapResource 接口 中 主要 的 属性 与 方法 。 


表 5-4 IMapResource 接口 中 主要 的 属性 与 方法 


属性 或 方法 说 明 

DisplaySettings 访问 或 修改 地 图 显示 属性 ， 例 如 透明 程序 、 背 景 颜 色 以 及 可 见 性 
MapInformation 获取 地 图 资源 范围 与 空间 参考 的 默认 值 

CreateFunctionality() 创建 功能 ， 例 如 查询 功能 

SupportsFunctionalityO 判断 该 资源 是 否 支持 某 类 型 的 功能 


下 面 的 代码 演示 了 通常 情况 下 ， 如 何不 需要 知道 具体 的 数据 源 ， 便 可 访问 地 图 资源 ， 并 改变 
地 图 资源 的 属性 。 代 码 首先 从 地 图 资源 管理 器 中 得 到 第 一 个 资源 的 对 象 , 然后 将 其 可 见 属性 设置 为 
true， 并 将 该 资源 所 生成 的 地 图 图 片 透明 程度 设置 为 50%。 

IMapResource mapresource = MapResourceManagerl.GetResource (0); 


mapresource.DisplaySettings.Visible - true; 
mapresource.DisplaySettings.Transparency - 50.0F; 


上 述 代 码 使 用 的 是 公有 API 中 的 IMapResource 接口 。 此 外 ， 数 据 源 专 有 的 地 图 资源 实现 类 可 
提供 更 多 数据 源 特 有 的 属性 。 要 得 到 专 有 地 图 资源 的 引用 ， 只 需 进 行 类 型 转换 即 可 ， 例 如 下 面 的 代 
码 将 公有 IMapResource 接口 转换 为 MapResourceLocal 类 型 ， 当 然 能 转换 的 前 提 是 该 资源 确实 是 
ArcGIS Server 本 地 数据 资源 : 


IMapResource mapresource = MapResourceManagerl.GetResource (0); 
MapResourceLocal mr = mapResource as MapResourceLocal; 


由 于 ArcGIS Server 本 地 数据 源 与 远程 数据 源 都 通过 ArcGIS Server SOAP API 与 服务 工作 , 它 
们 一 些 属性 与 方法 是 一 样 的 , 因此 Web ADF 为 这 两 类 数据 源 提供 了 一 个 基 类 , 即 MapResourceBase。 
通常 ， 这 两 者 在 Web ADF 中 都 使 用 值 对 象 ， 使 用 代理 类 与 GIS 服务 器 通信 。 表 5-5 列 出 了 它们 的 
共同 属性 。 


表 5-5 ArcGIS Server 本 地 资源 与 远程 资源 的 共同 属性 


属性 说 明 
MapDescription 访问 或 修改 MapDescription 值 对 象 。Web ADF 利用 该 对 象 管理 状态 
Service 地 图 资源 使 用 的 地 图 服务 的 名 称 


MapServerProxy 用 于 管理 与 ArcGIS Server 服务 之 间 的 SOAP 请 求 与 响应 


/ 
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如 果 不 需要 使 用 ArcGIS Server 本 地 或 远程 资源 特有 的 功能 ， 可 以 使 用 该 基 类 即 可 。 下 面 的 代 
码 演示 了 如 何 通过 MapResourceBase 类 得 到 ArcGIS Server 服务 的 名 称 : 
IMapResource mapresource = MapResourceManagerl.GetResource (0); 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceBase 
ags mapresourcebase — 
(ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceBase) 


mapresource; 
string ags servicename - ags mapresourcebase.Service; 


ArcGIS Server 远程 资源 是 通过 Web 服务 的 端点 与 ArcGIS Server 服务 工作 的 ， 对 应 的 类 为 
MapResourceIntemet。 由 于 只 能 通过 ArcGIS Server SOAP API 来 连接 Web 服务 (图 5.145. ， 因 此 
ArcGIS Server 远程 资源 无 法 访问 服务 器 上 下 文 。 


ArcGIS Server SOAP API 


MapDescription 


MapServerProxy 


图 5.14 ArcGIS Server 远程 资源 与 服务 器 只 通过 SOAP API 连接 


下 面 这 段 代码 演示 了 如 何 通过 远程 资源 得 到 ArcGIS Server 服务 的 默认 地 图 名 称 : 


IMapResource mapresource = MapResourceManagerl.GetResource (0); 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceInternet 
mapresource; 
mapresource = mapresource 
as ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceInternet ; 
ESRI.ArcGIS.ADF.ArcGISServer.MapServerProxy proxy = 
mapresource.MapServerProxy; 
string defaultmapname = proxy.GetDefaultMapName|(); 


ArcGIS Server 本 地 资源 可 通过 ArcObjects API 中 的 ServerContextInfo.ServerContext 属性 来 访 
问 服务 器 上 下 文 ， 并 管理 服务 器 对 象 ， 如 图 5.15 所 示 。 实 现 类 为 MapResourceLocal。 当 将 服务 器 
对 象 作为 Web ADF 资源 来 使 用 时 ， 并 不 需要 创建 与 释放 服务 器 上 下 文 ， 而 是 由 Web ADF 的 资源 
管理 器 控件 来 管理 。 
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ArcGIS Server SOAP API 


MapDescription 


MapServerProxy 


ArcGIS Server ArcObjects API 


IMapServer 


IServerContext 


图 5.15 ArcGIS Server 本 地 资源 可 通过 ArcObjects API 连接 


表 5-6 列 出 了 ArcGIS Server 本 地 资源 专 有 的 属性 与 方法 。 


表 5-6 ArcGIS Server 本 地 资源 专 有 的 属性 与 方法 
属性 与 方法 说 明 
ServerContextInfo 服务 器 上 下 文 信息 对 象 ， 包 括 服务 器 上 下 文 、 服 务 器 对 象 名 称 与 类 型 
MapServer 用 于 访问 ArcObjects 的 IMapServer 
MapServerProxy 用 于 访问 MapServerDcomProxy， 管 理 通过 IRequestHandler 接口 与 服务 


器 对 象 通信 的 SOAP 请 求 与 响应 
ApplyMapDescriptionToServer0 “” 当 改变 了 MapDescription 对 象 的 属性 后 ， 调 用 该 方法 ， 改 变 GIS 服务 器 


中 服务 器 对 象 实例 的 状态 。 
RefreshServerObjectsQ) 改变 GIS 服务 器 中 服务 器 对 象 实例 的 状态 


下 面 通过 一 个 实例 来 演示 如 何 使 用 MapResourceLocal。 本 实例 要 实现 的 功能 完全 与 5.3.3 节 中 
ContextManager 一 样 。 只 是 在 ContextManager 中 ， 没 有 通过 Web ADF， 而 是 直接 使 用 纯粹 的 


ArcObjects 类 。 
在 Visual Studio 2005 中 ， 利 用 File 菜单 的 New Web Site 命令 ， 创 建 一 新 的 Web 站 点 ， 命 名 
为 AdfAddDynamicData。 


从 工具 箱 的 ArcGIS Web Controls 选项 卡 中 ， 在 Defaultaspx 页 面 中 增加 一 地 图 资源 管理 器 控 
件 、 一 地 图 控件 、 一 工具 栏 与 Toc 控件 。 在 地 图 资源 控件 中 加 入 USAMap 资源 。 并 通过 工程 右键 
菜单 的 Add ArcGIS Identity 命令 加 入 身份 验证 信息 。 用 4.1.3 节 介 绍 的 方法 加 入 其 他 属性 设置 ， 使 
几 个 控件 能 联动 。 

再 从 工具 箱 的 HTML 选项 卡 中 , 加 入 两 个 mput(Button ) 控 件 , 分 别 设置 其 id 属性 为 AddLayer 
与 RemoveLayer，value 属性 为 “增加 图 层 ” 与 “删除 图 层 ”，onclick 属性 为 addlayer(addlayer) 与 
addlayer(removelayer) 。 在 Default.aspx 代码 的 <head> 与 </head> 之 间 加 入 如 下 代码 ， 以 响应 用 户 选 
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择 了 上 述 两 个 按钮 的 操作 : 


<script language="javascript" type="text/javascript"> 
function addlayer (argument) { 
var message — argument; 
var context = 'Mapl'; 
«$-addLayerCallback$» 
li 
</script> 


在 上 面 的 JavaScript 函数 中 ， 设 置 好 message 与 context 参数 后 ， 执 行 回调 。 

切换 到 Default.aspx.cs 文件 中 ， 在 头 部 加 入 如 下 命名 空间 : 

using ESRI.ArcGIS.Server; 

using ESRI.ArcGIS.Carto; 

using ESRI.ArcGIS.Geodatabase; 

using ESRI.ArcGIS.Geometry; 

using ESRI.ArcGIS.Display; 

using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 

为 了 应 用 回调 机 制 ， 需 要 _Default 类 实现 ICallbackEventHandler 接口 ， 因 此 将 其 声明 代码 
行 修改 为 如 下 代码 : 


public partial class Default : System.Web.UI.Page, ICallbackEventHandler 
在 类 中 加 入 如 下 字段 : 


public string addLayerCallback; 
private string callbackResponse; 
MapResourceLocal localMapResource - null; 


在 Page Load 方法 中 加 入 如 下 代码 ， 生 成 一 个 对 客户 端 函数 的 引用 : 


protected void Page Load(object sender, EventArgs e) { 
addLayerCallback - ClientScript.GetCallbackEventReference (this, 
"message", "processCallbackResult", "context", "postBackError", true); 


) 
接着 需要 完成 的 当然 就 是 ICallbackEventHandler 接口 实现 。 该 接口 需要 的 两 个 方法 的 代码 如 下 : 


string ICallbackEventHandler.GetCallbackResult() { 
return callbackResponse; 


) 


void ICallbackEventHandler.RaiseCallbackEvent (string eventArgument) { 
if (eventArgument.Contains ("addlayer")) ( 
AddLayer(); 
) 
else if (eventArgument.Contains ("removelayer")) { 
Session["layeradded"] - false; 
RemoveLayer () ; 
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E 要 工作 是 在 RaiseCallbackEvent 方法 中 完成 的 ， 该 方法 通过 判断 传 入 的 参数 是 addlayer 还 是 


removelayer， 分 别 执行 增加 图 层 方法 AddLayer 与 删除 图 层 方法 RemoveLayer。 
增加 图 层 AddLayer 方法 的 代码 如 下 : 


private void AddLayer() { 


} 


MapFunctionality agsMapFunctionality = Mapl.GetFunctionality (0) 
as MapFunctionality; 
localMapResource - (MapResourceLocal)agsMapFunctionality.Resource; 


// 使 用 Arcobjects 增加 动态 图 层 
IServerContext mapContext = 
localMapResource.ServerContextInfo.ServerContext; 


IWorkspaceFactory workspaceFactory = 
(IWorkspaceFactory)mapContext.CreateObject ( 
"esriDataSourcesFile.ShapefileWorkspaceFactory"); 

IFeatureWorkspace featureWorkspace = 
workspaceFactory.OpenFromFile (@"C:\ProgramFiles\ArcGIS\DeveloperKit\ 

SamplesNETNServerNMdataNNorthAmerica", 0) 
as IFeatureWorkspace; 

IFeatureLayer featureLayer = 
(IFeatureLayer)mapContext.CreateObject ("esriCarto.FeatureLayer"); 

featureLayer.FeatureClass - 
featureWorkspace.OpenFeatureClass ("canada.shp"); 

featureLayer.Name - "Canada"; 


// 应 用 着 色 器 
ApplyRenderer(featureLayer, mapContext); 


IMapServerObjects mapServerObjects - localMapResource.MapServer 
as IMapServerObjects; 

IMap map = mapServerObjects.get Map(localMapResource.DataFrame); 

map.AddLayer (featureLayer); 

map.MoveLayer(featureLayer, map.LayerCount - 1); 


// 刷新 服务 器 对 象 ， 响 应 添加 图 层 


localMapResource.RefreshServerObjects(); 


// 刷新 地 图 与 Toc 
Tocl.Refresh(); 
Mapl.CallbackResults.CopyFrom(Tocl.CallbackResults); 


Mapl.Refresh(); 
callbackResponse = Mapl.CallbackResults.ToString(); 


在 上 面 的 代码 中 , 通过 绘图 功能 得 到 MapResourceLocal 对 象 , 通过 该 对 象 的 ServerContextInfo 
属性 的 ServerContext 属性 得 到 服务 器 上 下 文 对 象 。 然 后 利用 该 对 象 的 CreateObject 方法 创建 工作 
空间 工厂 对 象 与 要 素 图 层 对 象 。 在 设置 好 图 层 的 着 色 器 以 后 , 在 地 图 中 加 入 图 层 , 接着 调用 本 地 资 
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源 对 象 的 RefreshServerObjects 方法 刷新 服务 器 对 象 ， 最 后 刷新 地 图 与 Toc. 
其 中 ApplyRenderer 方法 的 代码 如 下 ， 用 于 为 图 层 指 定 着 色 器 : 


// 设置 动态 要 素 图 层 的 着 色 器 对 象 
private void ApplyRenderer (IFeatureLayer featureLayer, 
IServerContext mapContext) { 

IGeoFeatureLayer geoLayer = (IGeoFeatureLayer)featureLayer; 


ISimpleRenderer simpleRenderer - (ISimpleRenderer) 
mapContext.CreateObject ("esriCarto.SimpleRenderer"); 
IRgbColor rgbColor = 
(IRgbColor)mapContext.CreateObject ("esriDisplay.RgbColor"); 
rgbColor.Red - 0; 
rgbColor.Green - 0; 
rgbColor.Blue - 210; 


esriGeometryType geometryType = featureLayer.FeatureClass.ShapeType; 
if (geometryType == esriGeometryType.esriGeometryPoint) 
{ 
ISimpleMarkerSymbol symbol = (ISimpleMarkerSymbol) 
mapContext.CreateObject ("esriDisplay.SimpleMarkerSymbol"); 
symbol.Color - (IColor)rgbColor; 
simpleRenderer.Symbol = (ISymbol)symbol; 


) 
else if (geometryType -- esriGeometryType.esriGeometryPolyline) ( 
ISimpleLineSymbol symbol = (ISimpleLineSymbol) 
mapContext.CreateObject ("esriDisplay.SimpleLineSymbol"); 
symbol.Color - (IColor)rgbColor; 
simpleRenderer.Symbol = (ISymbol)symbol; 
) 
else if (geometryType == esriGeometryType.esriGeometryPolygon) ( 
ISimpleFillSymbol symbol = (ISimpleFillSymbol) 
mapContext.CreateObject ("esriDisplay.SimpleFillSymbol"); 
symbol.Color - (IColor)rgbColor; 
simpleRenderer.Symbol = (ISymbol)symbol; 
) 
else ( 
throw new Exception (" 不 能 确定 图 层 类 型 ") ; 
) 


geoLayer.Renderer - (IFeatureRenderer)simpleRenderer; 


l 
删除 图 层 RemoveLayer 方法 的 代码 如 下 : 


private void RemoveLayer() { 
MapFunctionality agsMapFunctionality = Mapl.GetFunctionality (0) 
as MapFunctionality; 
localMapResource - (MapResourceLocal)agsMapFunctionality.Resource; 


// 通过 RArcobjects 删除 动态 添加 的 图 层 
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IMapServerObjects mapServerObjects = localMapResource.MapServer 
as IMapServerObjects; 

IMap map = mapServerObjects.get Map(localMapResource.DataFrame); 
ILayer workingLayer = null; 
IEnumLayer enumLayer = map.get Layers(null, true); 
ILayer loopLayer = null; 
while ((loopLayer = enumLayer.Next()) != null) { 

if (loopLayer.Name == "Canada") { 

workingLayer = loopLayer; 


} 


} 


map.DeleteLayer (workingLayer); 


// 刷新 服务 器 对 象 ， 响 应 删除 图 层 


localMapResource.RefreshServerObjects(); 


Tocl.Refresh(); 
Mapl.CallbackResults.CopyFrom(Tocl.CallbackResults); 


Mapl.Refresh(); 
callbackResponse - Mapl.CallbackResults.ToString(); 
} 


在 删除 图 层 的 方法 中 ， 首 先 得 到 本 地 资源 对 象 ， 从 该 对 象 中 得 到 服务 器 对 象 ， 从 该 对 象 中 得 
到 地 图 对 象 ， 从 地 图 对 象 中 删除 加 入 的 图 层 。 然 后 调用 本 地 资源 对 象 的 RefreshServerObjects 方法 ， 
刷新 服务 器 对 象 。 最 后 刷新 Toc 与 地 图 。 

编译 并 运行 程序 ， 通 过 “增加 按钮 图 层 “ 与 ”删除 图 层 ” 两 个 按钮 分 别 添加 与 删除 图 层 。 运 
行 效果 如 图 5.16 所 示 。 
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图 5.16 通过 本 地 地 图 资源 对 象 添加 图 层 
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5.4.3 ”地 图 资源 的 功能 


地 图 资源 可 提供 绘图 功能 、 查 询 功能 、 在 Toc 中 显示 功能 、 地 图 切片 功能 以 及 比例 尺 显示 功 


1. 绘图 功能 


使 用 地 图 资源 最 多 的 当然 是 地 图 控件 。 地 图 控件 使 用 每 个 地 图 资源 创建 一 个 相应 的 绘图 功能 。 
绘图 功能 类 的 Resource 属性 是 抽象 的 IMapResource 接口 的 引用 ,而 MapResource 属性 则 对 应 特定 
地 图 资源 类 的 引用 。 地 图 控件 提供 了 两 个 方法 来 得 到 功能 对 象 ， 一 个 是 GetFunctionalities 方法 ， 返 
回 一 组 IMapFunctionality 对 象 ， 另 一 个 是 GetFunctionality 方法 ， 根 据 参 数 的 值 返回 一 个 
IMapFunctionality 对 象 。 

从 开发 者 的 角度 来 看 ， 一 般 在 以 下 三 种 情况 时 会 使 用 绘图 功能 。 一 是 得 到 地 图 资源 的 元 数据 ， 
例如 地 图 中 包含 的 图 层 名 、 图 层 也、 比例 尺 以 及 空间 参考 等 ， 二 是 绘制 地 图 ， 三 是 使 用 地 图 资源 
特定 数据 源 专 有 的 功能 。 

表 5-7 列 出 了 地 图 功能 类 主要 的 属性 与 方法 。 


表 5-7 地 图 功能 类 主要 的 属性 与 方法 


属性 或 方法 说 明 

SpatialReference 表示 地 图 资源 的 空间 参考 

DisplaySettings 绘制 地 图 时 使 用 的 一 些 属 性 ， 例 如 透明 程序 、 背 景 颜色 等 
MaintainsState 该 属性 决定 是 否 使 用 功能 或 资源 来 维护 状态 

GetLayers 得 到 地 图 资源 中 所 有 图 层 的 名 称 与 ID 
Get\SetLayerVisibility0 改变 图 层 的 可 见 性 

Getscale0 返回 当前 显示 比例 尺 

DrawExtent() 生成 一 张 地 图 图 片 


IMapFunctionality 作为 公有 API 中 的 接口 ， 在 使 用 时 不 需要 知道 底层 使 用 的 具体 的 数据 源 类 
型 。 还 要 注意 的 是 , 在 地 图 控件 中 ,将 一 绘图 功能 作为 一 个 图 层 来 使 用 ,但 是 绘图 功能 自身 可 能 包 
含 了 许多 图 层 。 在 本 节 后 面 的 实例 中 将 演示 如 何 得 到 地 图 控件 中 所 有 的 绘图 功能 ， 以 及 每 个 绘图 功 
能 所 包含 的 图 层 。 

绘图 功能 一 个 重要 的 特点 是 ，Web ADF 使 用 它 来 维护 用 户 会 话 过 程 中 的 状态 。 绘 图 功能 中 存 
储 了 生成 地 图 图 片 的 对 象 的 引用 ， 例 如 可 见 图 层 、 地 图 属性 等 。Web ADF 以 无 状态 的 方式 使 用 数 
据 源 ， 这 意味 着 数据 源 是 不 保存 状态 。Web ADF 是 在 Web 层 保存 状态 的 ， 因 此 ， 可 以 在 程序 运行 
期 间 改变 地 图 功能 的 属性 ， 并 在 当前 会 话 过 程 中 维护 该 状态 。 例 如 ， 当 在 地 图 功能 中 加 入 服务 器 端 
的 图 形 后 (例如 在 ArcGIS Server 数据 源 的 MapDescription 中 加 入 GraphicElements， 即 4.4.3 节 中 
介绍 的 方法 ) ， 在 与 服务 器 数据 源 请 求 过 程 中 会 一 直 保 留 ， 而 不 需要 每 次 请 求 时 重新 加 入 。 

下 面 通过 一 个 实例 来 介绍 如 何 使 用 公有 API 中 的 地 图 功能 。 该 实例 实现 的 功能 有 些 类 似 Toc 
控件 的 功能 ， 可 用 来 显示 各 资源 及 其 图 层 的 可 见 性 ， 并 可 控制 它们 的 可 见 性 。 

在 Visual Studio 2005 中 ， 利 用 File 菜单 的 New Web Site 命令 ,创建 一 新 的 Web 站 点 ， 命 名 
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为 SetLayerVisibility。 
从 工具 箱 的 ArcGIS Web Controls 选项 卡 中 ， 在 Default.aspx 页 面 中 增加 一 地 图 资源 管理 器 控 
件 、 一 地 图 控件 与 一 工具 栏 控件 。 在 地 图 资源 控件 中 先后 加 入 USAMap 与 NorthAmericaMap 资源 ， 
并 将 NorthAmericaMap 资源 的 可 见 属性 设置 为 false。 通 过 工程 右键 菜单 的 Add. ArcGIS Identity ái 
令 加 入 身份 验证 信息 。 用 4.1.3 节 介 绍 的 方法 加 入 其 他 属性 设置 ， 使 几 个 控件 能 联动 。 
从 工具 箱 的 HTML 选项 卡 中 , 在 Default aspx 页 面 中 增加 一 Div 控件 , ID 设置 为 layerListDiv， 
放置 在 地 图 控件 的 右 侧 。 
本 实例 用 到 了 一 个 JavaScript 文件 、 一 样式 文件 与 一 些 图 标 文件 ， 需 要 读者 将 本 书 源 文件 中 
SetLayerVisibility 目录 下 的 TreeRes 文件 夹 拷贝 到 读者 创建 的 工程 的 目录 中 。 
在 Default.aspx 文件 的 <head> 与 </head> 之 间 加 入 如 下 代码 ， 引 用 上 述 样式 文件 与 JavaScript X 
件 : 
<link rel="stylesheet" type="text/css" href-"TreeRes/XMLSelTree.css" /> 
<script language="javascript" src="TreeRes/SimpleSelTree.js" 
type = "text/javascript"/> 
由 于 希望 程序 启动 后 立即 显示 地 图 资源 及 其 图 层 状态 信息 ， 因 此 在 Defaultaspx 文件 需要 加 入 
如 下 JavaScript 语句 : 
«script type-"text/javascript" language-"javascript"» 
function window.onload() ( 


GetMapLayers(); 


) 
</script> 


该 代码 表示 页 面 加 载 时 执行 GetMapLayers 函数 ,该 函数 是 我 们 自 定义 的 。 在 <head> 与 </head> 
之 间 加 入 该 函数 的 代码 ， 如 下 所 示 : 


<script language="javascript" type="text/javascript"> 
function GetMapLayers() { 
var message = 'ActiveType-GetMapLayers'; 
var context - 'Pagel'; 
«$-getMapLayersCallBack$» 
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} 
</script> 
上 述 代 码 执行 时 调用 getMapLayersCallBack 代表 的 回调 代码 。 
在 Default.aspx.cs 文件 中 ,首先 将 类 的 声明 代码 行 后 面 加 入 对 ICallbackEventHandler 接口 的 实 
然后 在 类 中 加 入 如 下 两 个 字段 : 


public string getMapLayersCallBack; // 客户 端 函数 的 引用 
private string callbackArg; // 回调 事件 的 结果 


在 Page Load 方法 中 加 入 如 下 代码 ， 获 取 一 个 对 客户 端 函数 的 引用 : 


protected void Page Load(object sender, EventArgs e) ( 
getMapLayersCallBack = ClientScript.GetCallbackEventReference (this, 
"message", "processCallbackResult", "context", "postBackError", true); 


p 


第 5 章 数据 源 、 资 源 与 功能 对 象 4 


加 入 ICallbackEventHandler 接口 要 求 的 两 个 方法 的 实现 代码 ， 如 下 所 示 ; 


void ICallbackEventHandler.RaiseCallbackEvent (string eventArgument) { 
callbackArg = eventArgument; 


) 


string ICallbackEventHandler.GetCallbackResult () 
t 
// 将 传 入 参数 依据 & 分 割 符 分 到 querystring 变量 中 
Array keyValuePairs = callbackArg.Split ("&".ToCharArray ()); 
NameValueCollection queryString = new NameValueCollection(); 
string[] keyValue; 
string response - ""; 
if (keyValuePairs.Length > 0) ( 
for (int i = 0; i < keyValuePairs.Length; i++) ( 
keyValue - 
keyValuePairs.GetValue(i).ToString().Split("-".ToCharArray()); 
queryString.Add(keyValue[0], keyValue[1]); 
) 
) 
else ( 
keyValue = callbackArg.Split ("-".ToCharArray()):; 
if (keyValue.Length » 0) 
queryString.Add(keyValue[0], keyValue[1]); 
) 


// 针对 参数 中 指定 的 ActiveType 不 同 执行 不 同 操作 
string controlType = queryString["ActiveType"]; 
Switch (controlType) ( 
case "GetMapLayers": 
response = GisFunctionality.GetMapLayers (Mapl); 
break; 
default: 
break; 
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return response; 


) 

上 述 代码 与 前 面 一 些 实例 的 很 类 似 ， 实 现 获 取 地 图 资源 及 其 图 层 信息 的 是 GisFunctionality 类 
的 GetMapLayers 方法 。 

在 工程 中 加 入 ASP.NET 文件 夹 App Code， 在 其 中 新 增加 GisFunctionality 类 。 在 该 类 中 首先 
加 入 如 下 一 些 命名 空间 的 引用 : 


using System.Collections; 

using ESRI.ArcGIS.ADF.Web.UI.WebControls; 

using ESRI.ArcGIS.ADF.Web.DataSources; 

GetMapLayers 方法 要 实现 的 功能 是 ， 依 据 地 图 控件 地 图 资源 及 其 图 层 ， 构 造 一 类 似 Toc 控件 
内 容 的 字符 串 ， 将 该 字符 串 作 为 layerListDiv 的 内 容 显示 。 代 码 如 下 : 
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public static string GetMapLayers (Map map) { 
System.Text.StringBuilder strBld = new System.Text.StringBuilder(); 


IEnumerable gfc = map.GetFunctionalities(); 
foreach (IGISFunctionality gisfunc in gfc) ( 
IMapFunctionality mf = gisfunc as IMapFunctionality; 
if (mf — null) 
continue; 


strBld.Append("«div class-'clsItem' type-'branch'»"); 
strBld.Append(G8"«img type-'img' 
onclick-'MouseClick(this)' src-'TreeRes/Images/NodeImgl.gif' /»"); 
bool resourceVisible = mf.DisplaySettings.Visible; 
string checkedValue - ""; 
if (resourceVisible) 
checkedValue - "checked-'checked'"; 
string inputBox = string.Format ("<input id-'(0]' type-'checkbox' 
onclick-'ResourceVisible(this)' (1)/»", 
mf.Resource.Name, checkedValue); 
strBld.Append (inputBox); 


string head = @"<span class-'clsLabel' 
type-'label' 
onmouseover-'NodeMouseOver (this); ' 
onmouseout- 'NodeMouseOut (this) ' 
style-'position: relative; left: -4px;'» 

<span class-'Link'»"; 

strBld.Append (head); 

strBld.Append (mf.Resource.Name); 

strBld.Append("«X/span»«/span»«div class-'hide' type-'container'»"); 
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string[] layerIDs; 

string[] layerNames; 

mf.GetLayers (out layerIDs, out layerNames); 

for (int i-0; i«layerIDs.Length; i++) ( 
strBld.Append("«div class-'clsItem' type-'leaf'»"); 
string checkedLayer = ""; 
bool layerVisible = mf.GetLayerVisibility (layerIDs[il):; 


if (layerVisible) 
checkedLayer = "checked-'checked'"; 
string layerInputBox = string.Format ("<input id-'(0)"' 
type-'checkbox"' 
onclick-M"LayerVisible(this, '(1)')N" (2)/»", 
layerIDs[i], mf.Resource.Name, checkedLayer); 
strBld.Append(layerInputBox); 
strBld.Append(G8"«span class-'clsLabel' type-'label' 
onmouseover-'NodeMouseOver (this);"' 
onmouseout-'NodeMouseOut (this);"' 
style-'position:relative;left:2px;' >"); 
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strBld.Append (layerNames[i]l); 
strBld.Append("«/span»«/div»"); 


) 


strBld.Append ("</div></div>"); 
} 


CallbackResult cr = new CallbackResult ("div", "layerListDiv", 
"innercontent", strBld.ToString()); 
map.CallbackResults.Add(cr); 
return map.CallbackResults.ToString():; 
} 
在 上 面 的 代码 中 , 首先 调用 地 图 控件 的 GetFunctionalities 方法 得 到 所 有 的 功能 , 然后 对 每 个 功 


能 进行 循环 。 
在 循环 的 代码 中 ， 只 对 绘图 功能 进行 处 理 。 调 用 绘图 功能 的 GetLayers 方法 得 到 该 功能 中 所 有 
图 层 及 其 ID， 然 后 对 图 层 进行 循环 ， 得 到 每 个 图 层 的 名 称 ， 并 用 GetLayerVisibility 方法 得 到 图 层 
的 可 见 性 ， 依 据 可 见 性 构造 HTML 控件 。 
代码 最 后 使 用 CallbackResult 方法 将 构造 好 的 字符 串 指定 显示 到 类 型 为 “Div”,， ID 为 
“layerListDiv” 的 控件 中 。 
编译 并 运行 程序 ， 运 行 效果 如 图 5.17 所 示 。 
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图 5.17 得 到 地 图 资源 及 其 图 层 的 名 称 与 可 见 性 


在 上 面 的 代码 中 ， 实 现 了 得 到 地 图 资源 及 其 图 层 的 名 称 与 可 见 性 ， 下 面 要 完成 的 是 控制 地 图 
资源 及 图 层 的 可 见 性 ， 在 前 面 的 代码 中 ， 我 们 已 经 为 每 个 复 选 框 指定 了 onclick 事件 响应 函数 ， 对 
于 资源 级 别 的 复 选 框 使 用 的 是 ResourceVisible 函数 ， 对 于 图 层级 别 使 用 的 是 LayerVisible。 

先 来 实现 控制 地 图 资源 的 可 见 性 。 在 Default.aspx 的 JavaScript 代码 段 中 ， 加 入 如 下 代码 ， 以 
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响应 用 户 选 择 资源 级 别 的 复 选 框 的 操作 : 


function ResourceVisible(checkBox) { 
Var message = 'ActiveType-SetResource&ResourceName-'; 
message += checkBox.id; 
message += "&Visible-" + checkBox.checked; 
var context = 'Pagel'; 
«$-resourceCallBack$» 


} 
然后 切换 到 Default.aspx.cs 文件 中 ， 加 入 一 个 字段 : 


public string resourceCallBack; 
在 Page_Load 方法 中 加 入 如 下 代码 ， 获 取 一 个 对 客户 端 函数 的 引用 : 


resourceCallBack = ClientScript.GetCallbackEventReference (this, 
"message", "processCallbackResult", "context", "postBackError", true); 


然后 在 GetCallbackResult 方法 的 switch 语句 中 加 入 如 下 case 语句 段 ， 用 于 通过 调用 
SetResourceVisibility 方法 实现 设置 地 图 资源 的 可 见 性 : 


Case "SetResource": 
response = GisFunctionality.SetResourceVisibility (Mapl, 
queryString["ResourceName"], queryString["Visible"]); 
break; 


SetResourceVisibility 方法 的 代码 如 下 : 


public static string SetResourceVisibility(Map map, string resourceName, 
string visibled) { 
IGISFunctionality gisfunc = map.GetFunctionality (resourceName); 
if (gisfunc == null) 
return ""; 


IMapFunctionality mf = gisfunc as IMapFunctionality; 


if (visibled == "true") 
mf.DisplaySettings.Visible - true; 
else 


mf.DisplaySettings.Visible false; 


RefreshMap (map, resourceName); 


return map.CallbackResults.ToString(); 
) 


代码 很 简单 ， 首 先 通过 地 图 控件 的 GetFunctionality 方法 ， 得 到 用 户 选 择 的 地 图 资源 的 功能 ， 
然后 通过 设置 该 功能 对 象 的 DisplaySettings 属性 的 Visible 属性 ， 从 而 控制 地 图 资源 的 可 见 性 ， 然 
后 调用 RefreshMap 方法 刷新 地 图 ， 最 后 返回 地 图 回调 对 象 中 保存 的 回调 内 容 。 

RefreshMap 方法 的 代码 如 下 ， 用 于 根据 不 同属 性 的 设置 调用 不 同 的 方法 来 刷新 地 图 : 

public static void RefreshMap (Map map, string resourceName) { 


if (map.ImageBlendingMode == ImageBlendingMode.WebTier) { 
map.Refresh(); 
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else if (map.ImageBlendingMode == ImageBlendingMode.Browser) { 
map.RefreshResource (resourceName); 


} 

编译 并 运行 程序 ， 读 者 现在 应 该 可 以 控制 两 个 地 图 资源 的 可 见 性 了 。 下 面 要 实现 的 是 控制 图 
层 的 可 见 性 。 

在 Default.aspx 的 JavaScript 代码 段 中 ， 加 入 如 下 代码 ， 响 应 用 户 选 择 图 层级 别 的 复 选 框 的 操 
作 : 


function LayerVisible (checkBox, resourceName) { 
var message = 'ActiveType-SetLayer&ResourceName-'; 
message += resourceName; 
message += "&LayerID-" + checkBox.id; 
message += "&Visible-" + checkBox.checked; 
var context - 'Pagel'; 
«$-layerCallBack$» 
} 


然后 切换 到 Default.aspx.cs 文件 中 ， 加 入 一 个 字段 : 
public string layerCallBack; 
在 Page Load 方法 中 加 入 如 下 代码 ， 获 取 一 个 对 客户 端 函数 的 引用 : 


layerCallBack- ClientScript.GetCallbackEventReference (this, 
"message", "processCallbackResult", "context", "postBackError", true); 


然后 在 GetCallbackResult 方法 的 switch 语句 中 加 入 如 下 case 语句 段 ， 用 于 通过 调用 
SetLayerVisibility 方法 实现 设置 地 图 资源 的 可 见 性 : 


case "SetLayer": 
response = GisFunctionality.SetLayerVisibility( 
Mapl, queryString["ResourceName"], 
queryString["LayerID"], queryString["Visible"]); 
break; 


SetLayerVisibility 方法 的 代码 如 下 : 


public static string SetLayerVisibility(Map map, string resourceName, 
string layerId, string visibled) 
{ 
IGISFunctionality gisfunc = map.GetFunctionality (resourceName); 
if (gisfunc == null) 
return ""; 
IMapFunctionality mf = gisfunc as IMapFunctionality; 
if (visibled == "true") 
mf.SetLayerVisibility(layerlId, true); 
else 
mf.SetLayerVisibility(layerld, false); 


RefreshMap (map, resourceName); 
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return 


} 


map.CallbackResults.ToString(); 


在 上 述 代 码 中 ， 通 过 绘图 功能 的 SetLayerVisibility 方法 设置 图 层 的 可 见 性 。 
编译 并 运行 程序 。 现 在 我 们 可 以 不 需要 Toc 控件 ， 而 使 用 自 定义 的 代码 来 控制 地 图 中 图 层 的 
可 见 性 了 。 程 序 运行 效果 如 图 5.18 所 示 。 


Untitled Page - Wicrosoft Internet Explorer 
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图 5.18 控制 地 图 资源 及 其 图 层 的 可 见 性 


2. 查询 功能 


IQueryFunctionaltiy 接口 提供 对 数据 源 的 要 素数 据 执行 空间 与 属性 的 查询 功能 。 要 获取 该 功能 ， 
必须 使 用 地 图 资源 的 CreateFunctionality 方法 来 创建 。 在 大 多 数 情况 下 ， 只 需要 使 用 公有 API 中 的 
IQueryFunctionaltiy 接口 即 可 实现 查询 功能 ， 只 有 在 很 少 的 特殊 情况 下 才 需 要 使 用 数据 源 特有 的 查 


询 功 能 。 


表 5-8 列 出 了 IQueryFunctionaltiy 接口 提供 的 主要 方法 。 


方法 


表 5-8 IQueryFunctionaltiy 接口 的 主要 方法 


说 明 


GetQueryableLayers 得 到 能 用 于 查询 的 要 素 图 层 的 名 称 及 ID 数组 。 地 图 中 有 些 图 层 是 不 能 查询 的 ， 


GetFields 
Find 
Identify 


例如 栅 格 图 层 
返回 地 图 资源 中 某 图 层 的 字段 数组 

对 地 图 资源 中 的 一 个 或 多 个 图 层 查询 某 个 值 ， 返 回 一 DataTable 数组 
对 地 图 资源 中 的 一 个 或 多 个 图 层 执行 空间 查询 ， 即 通过 图 形 查 询 属性 


Query 对 地 图 资源 中 的 一 个 图 层 执行 空间 与 /或 属性 查询 
GetQueryableLayers 与 GetFields 方法 用 于 在 地 图 资源 中 找到 能 用 于 查询 的 信息 。Find、Identify 


与 Query 方法 返 


回 的 是 ADONET 中 常用 的 数据 对 象 System .Data.DataTable 类 型 。 如 果 查 询 返 回 
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Web ADF 的 几何 图 形 ， 可 以 在 图 形 资源 的 图 形 图 层 中 使 用 。 

在 第 4 章 中 介绍 了 Identify 与 Query 两 个 方法 ， 下 面 通过 一 个 实例 来 介绍 Find 方法 的 使 用 。 
该 实例 要 实现 的 功能 是 全 文 搜索 ， 在 所 有 图 层 的 所 有 字段 中 搜索 用 户 的 输入 。 

在 Visual Studio 2005 中 ， 利 用 File 菜单 的 New Web Site 命令 ， 创 建 一 新 的 Web 站 点 ， 命 名 
为 FullSearch 。 

同样 ， 本 实例 用 到 了 一 个 样式 文件 与 一 些 图 标 文件 ， 需 要 读者 将 本 书 源 代码 文件 中 
SetLayerVisibility 目录 下 的 css 与 Images 文件 夹 拷 贝 到 读者 创建 的 工程 的 目录 中 。 

从 工具 箱 的 ArcGIS Web Controls 选项 卡 中 ， 在 Default.aspx 页 面 中 增加 一 地 图 资源 管理 器 控 
件 、 一 地 图 控件 与 一 工具 栏 控 件 。 在 地 图 资源 控件 中 先后 加 入 一 图 形 图 层 、USAMap 与 
NorthAmericaMap 资源 。 并 通过 工程 右键 菜单 的 Add. ArcGIS Identity 命令 加 入 身份 验证 信息 。 用 
4.1.3 节 介 绍 的 方法 加 入 其 他 属性 设置 ， 使 几 个 控件 能 联动 。 

从 工具 箱 的 HTML 选项 卡 中 , 在 Default.aspx 页 面 中 地 图 控件 的 右 侧 增加 一 文本 框 控 件 、 一 按 
钮 控件 与 一 Div 控件 ， 将 其 id 分 别 设置 为 queryCondition、Query 与 resultDiv。 

将 按钮 控件 的 onclick 事件 设置 为 FullQuery0 函 数 ， 将 用 该 函数 来 响应 用 户 的 查询 。 在 
Default.aspx 的 <head></head> 中 加 入 如 下 代码 ， 用 于 设置 样式 文件 与 响应 用 户 的 查询 操作 : 

<link href="css/stylel.css" type="text/css" rel="stylesheet"/> 

<script language="javascript" type="text/javascript"> 

function FullQuery() { 
var condition = document .getElementById("queryCondition"); 


var message = 'ActiveType-FullQuery&Condtion-'; 
message += condition.value; 
var context - 'Pagel'; 


«$-fullQueryCallBack$» 
) 
«/script» 
切换 到 DefaulLaspxcs 文件 中 ， 修 改 _Default 类 的 声明 为 如 下 代码 ， 增 加 对 
ICallbackEventHandler 接口 的 实现 。 


public partial class Default : System.Web.UI.Page, ICallbackEventHandler 
TE Default 类 中 加 入 如 下 两 个 字段 : 


public string fullQueryCallBack; 
private string callbackArg; 


在 Page Load 方法 中 加 入 如 下 代码 : 


protected void Page Load(object sender, EventArgs e) { 
fullQueryCallBack - ClientScript.GetCallbackEventReference (this, 
"message", "processCallbackResult", "context", "postBackError", true); 


) 
然后 要 完成 的 是 回调 接口 需要 实现 的 两 个 方法 ， 代 码 如 下 : 


void ICallbackEventHandler.RaiseCallbackEvent (string eventArgument) { 
callbackArg = eventArgument; 
} 
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string ICallbackEventHandler.GetCallbackResult() { 
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} 


// 将 传 入 参数 依据 & 分 割 符 分 到 querystring 变量 中 
Array keyValuePairs = callbackArg.Split ("&".ToCharArray()):; 
NameValueCollection queryString = new NameValueCollection(); 
string[] keyValue; 
string response - ""; 
if (keyValuePairs.Length > 0) { 
for (int i = 0; i < keyValuePairs.Length; i++) ( 
keyValue = 
keyValuePairs.GetValue (i).ToString().Split("-".ToCharArray()); 
queryString.Add(keyValue[0], keyValue[1]); 


) 
else ( 
keyValue = callbackArg.Split ("-".ToCharArray()):; 
if (keyValue.Length » 0) 
queryString.Add(keyValue[0], keyValue[1]); 
} 


// 针对 参数 中 指定 的 ActiveType 不 同 执行 不 同 操作 
string controlType = queryString["ActiveType"]; 
switch (controlType) ( 
case "FullQuery": 
response = GisFunctionality.GetResourceContent (Mapl, 
queryString["Condtion"]); 
break; 
default: 
break; 


return response; 


上 面 的 代码 在 判断 用 户 执行 的 是 全 文 查询 操作 时 ， 调 用 GisFunctionality 类 的 静态 方法 


GetResourceContent 来 执行 查询 。 


在 工程 中 加 入 ASP.NET 的 文件 夹 APP. CODE， 并 在 其 中 加 入 Gourcer Wew 类 。 
在 Gourcer Wew 类 中 加 入 如 下 命名 空间 的 引用 : 


using System.Collections; 

using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.Web.DataSources; 
using ESRI.ArcGIS.ADF.Web; 


先 在 GetResourceContent 方法 中 加 入 如 下 代码 : 


public static string GetResourceContent (Map map, string condition) 


1 


System.Text.StringBuilder sbContent = new System.Text.StringBuilder(); 
sbContent.Append("«table border-0 cellpadding-0 
cellspacing-1 class-list-line»"); 
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sbContent.Append("«tr»«td class-listbg» Wii «/td» 
«td class=1istbg> 图 层 名 </td> 
«td class-listbg»iEÍE«/td»«/tr»"); 
) 
由 于 执行 的 是 全 文 搜索 ， 查 询 结果 可 能 分 布 在 不 同 的 地 图 资源 中 ， 还 可 能 在 同一 个 图 层 中 有 
几 个 记录 满足 条 件 。 因 此 需要 一 个 表格 将 查询 结果 按 资源 与 图 层 列 出 来 。 在 上 面 的 代码 中 , 先 构造 
了 一 个 表格 的 框架 。 
接着 要 实现 的 是 对 地 图 资源 进行 查询 。 在 GetResourceContent 方法 中 加 入 如 下 代码 : 
IEnumerable func enum = map.GetFunctionalities(); 


foreach (IGISFunctionality gisfunctionality in func enum) 


t 


IGISResource gisresource - gisfunctionality.Resource; 
bool supported - 
gisresource.SupportsFunctionality (typeof (IQueryFunctionality)); 


if (!supported) 
continue; 


IQueryFunctionality qfunc; 

qfunc = 
gisresource.CreateFunctionality (typeof (IQueryFunctionality), null) 
as IQueryFunctionality; 

if (gfunc -- null) 
continue; 


) 

由 于 地 图 中 包含 几 个 资源 , 因此 先 通过 地 图 控件 的 GetFunctionalities 得 到 所 有 的 功能 , 然后 对 
每 个 功能 进行 循环 查询 。 在 循环 中 首先 判断 资源 是 否 支持 查询 ， 如 果 不 支 持 ， 则 进行 下 一 个 循环 。 
如 果 支 持 查询 ， 则 调用 资源 的 CreateFunctionality 方法 ， 创 建 查询 功能 ， 如 果 不 成 功 ， 则 进行 下 一 
个 循环 。 

在 foreach 循环 中 再 加 入 如 下 代码 : 

string[] lids; 

string[] lnames; 

qfunc.GetQueryableLayers (null, out lids, out lnames); 

if (lids.Length « 1) 

continue; 

在 上 述 代码 中 , 通过 查询 功能 的 GetQueryableLayers 方法 得 到 资源 中 能 执行 查询 的 图 层 名 及 其 
对 应 ID 数组 。 由 于 是 图 形 图 层 资源 ， 没 有 图 层 可 返回 ， 因 此 需要 进行 数组 大 小 的 判断 。 

在 foreach 循环 中 再 加 入 如 下 代码 ， 构 造 查询 参数 : 

FindParameters findParam = new FindParameters(); 

findParam.FindOption - FindOption.AllLayers; 

findParam.FindString = condition; 

findParam.MaxRecords - 50; 

for (int i = 0; i < lids.Length; i++) { 

string[] fields = qgfunc.GetFields (null, lids[i]):; 
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findParam.LayersAndFields.Add(lids[il, fields); 
} 


上 述 代 码 得 到 对 图 层 数 组 进行 循环 ， 在 其 中 调用 查询 功能 的 GetFields 方法 得 到 每 个 图 层 的 所 
有 字段 ， 并 将 图 层 及 其 字段 加 入 到 查询 参数 对 象 的 LayersAndFields 属性 中 。 
在 foreach 循环 中 再 加 入 如 下 代码 : 


System.Data.DataTable[] dtable = qfunc.Find(null, findParam); 
if (dtable == null) 

continue; 
if (dtable.Length -- 0) 

continue; 


上 述 代码 调用 查询 功能 的 Find 方法 ， 根 据 查 询 参数 对 象 ， 对 整个 地 图 资源 进行 查询 ， 并 返回 
一 数据 表 数组 ， 如 果 没 有 找到 匹配 记录 ， 则 返回 结果 为 null 或 数组 长 度 为 0， 则 进行 对 象 下 一 个 资 
源 的 查询 。 

上 述 代 码 已 经 将 查询 结果 保存 在 了 数据 表 数组 中 了 ， 下 面 要 完成 的 是 根据 这 个 结果 ， 填 充 表 
格 。 

在 foreach 循环 中 再 加 入 如 下 代码 : 


for (int i = 0; i < dtable.Length; i++) { 
string formatStr = "<tr><td class=listbg>{0}</td> 
«td class-listbg»(1)«/td»"; 
formatStr += "<td class-listbg» 
<A href-WV"javascript: void Position('(2)', '(3)', 
'(4)', ' (5) ) VSsETBICA»«/td»«/tr»"; 
string primaryFieldName = PrimaryFieldName (dtable[i]); 
for (int j = 0; j < dtable[i].Rows.Count; j++) ( 
string rowPrimaryFieldValue = 
dtable[i].Rows[j] [primaryFieldName].ToString(); 
string row - string.Format (formatStr, 
gisresource.Name, dtable[i].TableName, 
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gisresource.Name, dtable[i].TableName, 
primaryFieldName, rowPrimaryFieldValue); 
sbContent.Append (row); 


) 

上 述 代码 对 数据 表 数 组 进行 循环 ， 在 其 中 对 数据 表 的 记录 集 进 行 循 环 ， 得 到 该 记录 的 主键 列 
的 值 ， 然 后 根据 该 值 、 资 源 名 称 以 及 图 层 名 称 ， 构 造 表 格 中 的 一 行 HTML 代码 ， 在 该 代码 中 包含 
一 个 超 链接 ， 我 们 将 利用 该 超 链 接 在 地 图 上 定位 到 该 行 对 应 的 要 素 。 

在 foreach 循环 之 后 加 入 如 下 代码 : 


sbContent . Append ("</table>"); 
CallbackResult cr = new CallbackResult ("div", "resultDiv", 


"innercontent", sbContent.ToString()); 
map.CallbackResults.Add (cr); 
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return map.CallbackResults.ToString(); 


上 述 代码 利用 CallbackResult 类 将 我 们 刚才 生成 的 表 作 为 resultDiv 控件 的 内 容 显 示 , 并 将 该 对 


象 加 入 到 地 图 控件 的 CallbackResults 属性 中 ， 最 后 将 该 属性 作为 字符 串 返回 。 


编译 并 运行 程序 ， 在 查询 条 件 文本 框 中 输入 加 拿 大 或 美国 的 州 名 ， 例 如 Saskatchewan, 


Minnesota 与 Alaska 等 。 程 序 运 行 效果 如 图 5.19 所 示 。 


J Untitled Page - Wicro 
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图 5.19 利用 功能 的 Find 方法 实现 全 文 搜索 


接着 要 实现 的 是 在 地 图 上 定位 查询 到 的 结果 。 
在 Default.aspx 的 <head> 与 </head> 之 间 的 JavaScript 函数 处 加 入 Position 函数 的 代码 ， 如 下 所 


function Position(resourceName, layerName, fieldName, fieldValue) ( 
var message = 'ActiveType-Position&ResourceName-'; 
message += resourceName; 
message += "&LayerName-" + layerName; 
message += "&FieldName-" + fieldName; 
message += "&FieldValue-" + fieldValue; 
var context = 'Pagel'; 
«$-positionCallBack$» 
} 
切换 到 Default.aspx.cs 文件 中 ， 在 类 中 首先 加 入 如 下 一 字段: 


public string positionCallBack; 
在 Page Load 方法 中 加 入 如 下 代码 ， 为 positionCallBack 赋值 : 


positionCallBack = ClientScript.GetCallbackEventReference (this, 
"message", "processCallbackResult", "context", "postBackError", true); 
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在 GetCallbackResult 方法 的 switch 中 加 入 如 下 case 代码 段 : 


case "Position": 
response = GisFunctionality.Position(Mapl, queryString["ResourceName"], 
queryString["LayerName"], 
queryString["FieldName"], 
queryString["FieldValue"]); 
break; 


上 述 代 码 调用 GisFunctionality 类 的 Position 方 法 实现 定位 选择 结果 .该 方法 的 代码 如 下 : 


public static string Position(Map map, string resourceName, 
string layerName, string fieldName, string fieldValue) { 
IGISFunctionality gisfunc = map.GetFunctionality (resourceName); 
if (gisfunc == null) 
return ""; 


IGISResource gisresource = gisfunc.Resource; 
bool supportquery = 
gisresource.SupportsFunctionality (typeof (IQueryFunctionality)); 
if (!supportquery) 
return ""; 


IQueryFunctionality qfunc; 

qfunc = 
gisresource.CreateFunctionality (typeof (IQueryFunctionality), null) 
as IQueryFunctionality; 


SpatialFilter spatialfilter - new SpatialFilter(); 
spatialfilter.ReturnADFGeometries = false; 
spatialfilter.MaxRecords = 1000; 
spatialfilter.WhereClause = fieldName + "=" + fieldValue; 


string layerId = GetQueryableLayerIDFromName (qfunc, layerName); 
System.Data.DataTable datatable = 

qfunc.Query(null, layerId, spatialfilter); 
if (datatable == null) 

return ""; 


return HighlightShow (map, datatable); 
) 


实现 代码 很 简单 ， 主 要 代码 是 调用 查询 功能 的 Query 方法 在 指定 图 层 中 查询 。 由 于 Query 77 


法 需要 的 是 图 层 的 ID ， 而 参数 传 进来 的 是 图 层 名 称 ， 因 此 在 调用 Query 方法 之 前 ， 调 用 了 
GetQueryableLayerIDFromName 方法 根据 图 层 名 得 到 图 层 的 人 D。 该 方法 及 其 支持 方法 的 代码 如 下 


public static string GetQueryableLayerIDFromName (IQueryFunctionality qfunc 
string layerName) ( 

string[] layerIDs; 

string[] layerNames; 

qfunc.GetQueryableLayers (null, out layerIDs, out layerNames); 
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return GetLayerID(layerIDs, layerNames, layerName); 


} 


public static string GetLayerID(string[] layerIDs, 
string[] layerNames, string findLayerName) { 

for (int i = 0; i < layerIDs.Length; i++) ( 

if (layerNames[i] == findLayerName) 

return layerIDs[i]; 


} 


return “mz 

} 

高 亮 显示 的 方法 ， 即 HighlightShow， 完 全 同 4.5 节 中 AttributeQuery 工程 中 同名 方法 ， 因 此 为 
节省 篇 幅 ， 这 里 不 再 给 出 。 

编译 并 运行 程序 ， 查 看 程序 运行 结果 。 运 行 效果 如 图 520 所 示 。 
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图 5.20 定位 查询 结果 
3. 其 他 功能 


虽然 对 于 程序 开发 人 员 来 说 ， 编 码 过 程 中 用 得 最 多 的 是 绘图 功能 与 查询 功能 ， 但 是 其 他 几 个 
功能 ， 特 别 是 Toc 功能 ， 也 是 整个 应 用 程序 不 可 缺少 的 部 分 。 

通过 MapTocFunctionality 可 访问 Toc 控件 中 数据 。 每 个 资源 对 应 一 个 TocDataFrame 对 象 , 而 
每 个 图 层 对 应 一 个 TocLayer 对 象 。 可 以 通过 绘图 功能 的 GetLayerVisibility 与 SetLayerVisibility 方 
法 来 改变 Toc 中 图 层 的 可 见 性 。 


口 TileFunctionality 能 够 利用 事先 创建 的 地 图 切片 文件 ， 而 不 是 每 次 都 使 用 绘图 功能 创建 地 


(m) 
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BAA. Web ADF 自身 只 针对 ArcGIS Server 数据 源 提供 该 功能 。 通 常 ， 
定义 数据 源 时 才 需 要 使 用 该 功能 。 
ScaleBarFunctionality 能 够 为 应 用 程序 生成 一 个 比例 尺 。 
下 面 我 们 通过 一 实例 来 演示 如 何 使 用 Toc 功能 。 要 实现 的 功能 是 在 页 面 上 显示 图 例 。 
在 Visual Studio 2005 中 ， 利 用 File 菜单 的 New Web Site 命令 ， 创 建 一 新 的 Web 站 点 ， 命 名 
为 FullSearch 。 
本 实例 用 到 的 样式 文件 与 一 些 图 标 文件 ， 需 要 读者 将 本 书 所 附 源 代码 文件 中 SetLayerVisibility 
目录 下 的 css 与 Images 文件 夹 拷 贝 到 读者 创建 的 工程 的 目录 中 。 
从 工具 箱 的 ArcGIS Web Controls 选项 卡 中 ， 在 Default.aspx 页 面 中 增加 一 地 图 资源 管理 器 控 
件 与 一 地 图 控件 。 在 地 图 资源 控件 中 NorthAmericaMap 资源 。 并 通过 工程 右键 菜单 的 Add ArcGIS 
Identity 命令 加 入 身份 验证 信息 。 用 4.1.3 节 介绍 的 方法 加 入 其 他 属性 设置 ， 使 几 个 控件 能 联动 。 
从 工具 箱 的 HTML 选项 卡 中 , 在 Default.aspx 页 面 中 地 图 控件 的 右 侧 增 加 一 Image 控件 , 将 其 
id 分 别 设置 为 legend， 将 其 高 与 宽 都 设置 为 200。 我 们 将 在 该 控件 中 显示 图 例 。 
由 于 我 们 希望 在 页 面 加 载 时 便 显示 图 例 。 因 此 需要 在 window 的 onload 事件 中 执行 回调 ， 利 
用 Toc 功能 绘制 一 图 例 图 象 。 在 Default.aspx 的 代码 的 最 后 加 入 如 下 代码 : 
<script type="text/javascript" language="javascript"> 
function window.onload() { 


GetLegend(); 
) 


3k 
ya 


有 在 使 用 自 


function GetLegend() ( 
var message = 'ActiveType-GetLegend'; 
var context - 'Pagel'; 
«$-getLegendCallBack$» 
) 
</script> 


切换 到 Defaultaspx.cs 文件 中 ， 首 先 在 _ Default 类 中 加 入 如 下 两 个 字段 : 


public string getLegendCallBack; // 客户 端 脚本 段 
private string callbackArg; // 返回 给 客户 端的 内 容 


在 Page Load 方法 中 加 入 如 下 代码 : 


protected void Page Load(object sender, EventArgs e) 
t 
// 利用 GetCallbackEventReference 方法 生成 客户 端 脚本 
getLegendCallBack = Page.ClientScript.GetCallbackEventReference (this, 
"message", "processCallbackResult", "context", "postBackError", true); 


) 
接着 要 实现 的 是 ICallbackEventHandler 接口 要 求 的 两 个 方法 ， 它 们 的 实现 代码 如 下 : 


void ICallbackEventHandler.RaiseCallbackEvent (string eventArgument) { 
callbackArg = eventArgument; 
} 


string ICallbackEventHandler.GetCallbackResult() { 
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// 将 传 入 参数 依据 & 分 割 符 分 到 querystring 变量 中 
Array keyValuePairs = callbackArg.Split("g".ToCharArray ()); 
NameValueCollection queryString = new NameValueCollection(); 
string[] keyValue; 
string response = ""; 
if (keyValuePairs.Length > 0) { 
for (int i = 0; i « keyValuePairs.Length; i++) ( 
keyValue = 
keyValuePairs.GetValue (i).ToString().Split ("-".ToCharArray()); 
queryString.Add(keyValue[0], keyValue[1]); 
) 


} 
else { 
keyValue = callbackArg.Split ("-".ToCharArray()); 
if (keyValue.Length » 0) 
queryString.Add(keyValue[0], keyValue[1]); 
} 


// 针对 参数 中 指定 的 ActiveType 不 同 执行 不 同 操作 
string controlType = queryString["ActiveType"]; 
switch (controlType) ( 

case "GetLegend": ( 


// 根 目录 虚拟 路 径 
string virtualPath = Page.Request.ApplicationPath; 
// 根 目录 绝对 路 径 
string pathRooted = 
HttpContext.Current.Server.MapPath (virtualPath); 

string savePath = pathRooted + "\\Output\\Legend. bmp"; 
response - GisFunctionality.GetLegend(Mapl, savePath); 
break; 

) 

default: 
break; 


} 


return response; 


} 


在 GetCallbackResult 方法 中 , 我 们 利用 HttpServerUtility 类 的 MapPath 方法 来 得 到 虚拟 路 径 相 
对 应 的 物理 文件 路 径 ， 然 后 加 上 Output\Legend.bmp， 这 就 是 我 们 保存 图 例 图 片 的 文件 所 在 绝对 路 
径 。 因 此 需要 读者 在 工程 中 创建 一 Output 文件 夹 。 

实现 保存 图 例 的 代码 是 GisFunctionality 类 的 GetLegend 类 。 

在 工程 中 加 入 ASP.NET 的 文件 夹 APP. CODE， 并 在 其 中 加 入 GisFunctionality 类 。 

首先 在 类 中 加 入 如 下 命名 空间 的 引用 : 

using System.Drawing; 

using ESRI.ArcGIS.ADF.Web; 


using System.Collections.Generic; 
using ESRI.ArcGIS.ADF.Web.DataSources; 
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using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
首先 在 GetLegend 中 加 入 如 下 代码 : 


public static string GetLegend (Map map, string savePath) { 
int printResolution = 96; 
int legendWidth = 200; 
int legendHeight - 200; 
int marginPadding - 10; 
int legendEntryPadding - 5; 
string legendTitle = "北美 地 图 图 


fi" ; 
) 


上 述 代码 定义 了 绘制 图 例 使 用 的 参数 ， 包 括 图 片 宽度 、 高 度 、 分 辨 率 以 及 名 称 。 接 着 在 方法 
中 加 入 如 下 代码 ， 得 到 图 例 信 息 : 


Dictionary<string, KeyValuePair<string, CartoImage>> legendInfo = null; 


legendInfo = new Dictionary<string, KeyValuePair<string, CartoImage>>(); 
int layerCounter = 0; 


foreach (IMapResource item in map.MapResourceManagerInstance.GetResources()) 
t 
IMapTocFunctionality mtoc - null; 
mtoc = item.CreateFunctionality(typeof (IMapTocFunctionality), null) 
as IMapTocFunctionality; 
if (mtoc -- null) 
continue; 
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IMapFunctionality mf = null; 
foreach (IGISFunctionality entry in item.Functionalities) { 
if (entry is IMapFunctionality) 
mf = entry as IMapFunctionality; 
) 
if (mf == null || !mf.DisplaySettings.Visible) 
continue; 


TocDataFrame[] tocDataFrames = mtoc.GetMapContents (mf.Name, 
WeblImageFormat.PNG24, true, false); 
foreach (TocDataFrame tocDataFrame in tocDataFrames) { 
foreach (TocLayer tocLayer in tocDataFrame) ( 
if (tocLayer.Visible) ( 
List«KeyValuePair«string, CartoImage>> legends = null; 
legends = GetLegendImages (tocLayer); 
if (legends != null && legends.Count > 0) ( 
foreach (KeyValuePair«string, Cartolmage» entry in legends) 
t 
legendInfo.Add (layerCounter.ToString(), 
new KeyValuePaircstring, Cartolmage» 


(entry.Key, entry.Value)); 
layerCountert*; 
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) 


在 上 面 的 代码 中 ， 对 地 图 控件 中 的 每 个 地 图 资源 进行 循环 。 由 地 图 资源 对 象 创建 Toc 功能 ， 
通过 该 功能 的 GetMapContents 方法 ， 得 到 TocDataFrame 对 象 数组 。 然 后 对 该 数组 进行 循环 。 在 该 
循环 中 对 TocDataFrame 对 象 中 的 TocLayer 对 象 组 进行 循环 。 在 该 循环 中 以 TocLayer 对 象 为 参数 ， 
调用 GetLegendImages 方法 ， 得 到 该 图 层 对 应 的 CartoImage 对 象 。 该 对 象 包 含 了 制图 需要 的 信息 。 

GetLegendImages 方法 的 代码 如 下 : 


private static List<KeyValuePair<string, CartoImage>> 
GetLegendImages (TocLayer tocLayer) 
t 

List«KeyValuePair«string, CartoImage>> legends = 
new List«KeyValuePair«string, CartoImage»»(); 

if (tocLayer !- null && tocLayer.Visible) ( 

if (tocLayer.TocSymbolGroupCount » 0) ( 
if (tocLayer.TocSymbolGroupCount == 1) ( 
TocSymbolGroup symbolGroupSingle = 

tocLayer.GetTocSymbolGroup (0); 


if (symbolGroupSingle.Count -- 1) ( 
TocSymbol tocSymbol = symbolGroupSingle[0]; 
legends.Add (new KeyValuePair«string, CartoImage»( 
tocLayer.LayerName, tocSymbol.Image)); 
} 
else { 
System.Collections.IEnumerator e = 
tocLayer .GetTocSymbolGroups (); 
// 增加 图 层 名 称 
if (e.MoveNext() && e.Current !- null) 
legends.Add(new KeyValuePair«string, Cartolmage»( 
tocLayer.LayerName, null)); 


e.Reset(); 
while (e.MoveNext()) ( 
// 增加 组 的 名 称 
TocSymbolGroup symbolGroup = e.Current as TocSymbolGroup; 
legends.Add (new KeyValuePair«string, CartolImage»( 
symbolGroup.Heading, null)); 


foreach (TocSymbol tocSymbol in symbolGroup) 
i 
// 增加 图 例 项 组 
legends.Add(new KeyValuePair<string，CartoImage>( 
tocSymbol.Label, tocSymbol.Image)); 
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System.Collections.IEnumerator e = 
tocLayer.GetTocSymbolGroups (); 
if (e.MoveNext() && e.Current !- null) 
legends.Add (new KeyValuePair«string, 
CartoImage» (tocLayer.LayerName, null)); 
e.Reset(); 
while (e.MoveNext()) ( 
TocSymbolGroup symbolGroup = e.Current as TocSymbolGroup; 
legends.Add (new KeyValuePair«string, 
CartoImage» (symbolGroup.Heading, null)); 


foreach (TocSymbol tocSymbol in symbolGroup) 
t 
legends.Add (new KeyValuePaircstring, 
CartoImage» (tocSymbol.Label, tocSymbol.Image)); 
) 
) 


if (tocLayer.TocLayerCount > 0) { 
System.Collections.IEnumerator subLayers = 
tocLayer.GetTocLayers(); 
while (subLayers.MoveNext()) ( 
List«KeyValuePair«string, Cartolmage»» subLayerLegends = 
GetLegendImages (subLayers.Current as TocLayer); 
if (subLayerLegends !- null) 
legends.AddRange (subLayerLegends); 
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} 


return legends; 


} 

该 方法 的 目的 就 是 得 到 一 个 TocLayer 中 所 有 的 子 TocLayer。 这 是 因为 对 于 某 些 专题 地 图 ， 图 
层 的 图 例 不 止 一 个 , 例如 独立 值 专题 地 图 , 每 个 要 素 都 用 一 种 不 同 的 方式 ， 所 以 该 图 层 中 有 多 少 要 
素 ， 那 么 就 有 多 少 个 图 例 。 

通过 上 述 的 代码 ， 得 到 了 所 有 图 例 的 信息 ， 包 括 子 图 例 信息 。 回 到 GetLegend 中 ， 加 入 如 下 
代码 ， 该 代码 用 于 创建 图 例 ， 并 将 其 保存 为 一 图 片 文件 : 


if (legendInfo == null || legendInfo.Count == 0) 
return ""; 
Bitmap legendImage - null; 
legendImage = new Bitmap(legendWidth, legendHeight); 
legendImage.SetResolution(printResolution, printResolution); 
Graphics graphics = Graphics.FromImage (legendImage); 
Font stringFont - new Font("Verdana", 8, System.Drawing.FontStyle.Bold); 
SolidBrush drawBrush = new SolidBrush (Color.Black); 
List«Bitmap» legendEntries = new List«Bitmap»(); 


foreach (KeyValuePair«string, KeyValuePaircstring, Cartolmage»^ 
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item in legendInfo) ( 
if (item.Value.Value !- null) ( 
Bitmap swatch = 
new Bitmap (new System.IO.MemoryStream( 
item.Value.Value.MimeData.Bytes)); 
float swatchColumnWidth = 
(swatch.Width * (printResolution / swatch.HorizontalResolution)) 
> 100 2 100: 
(swatch.Width * (printResolution / swatch.HorizontalResolution)); 
SizeF textSize - graphics.MeasureString(item.Value.Key, stringFont, 
(int) (legendWidth - swatchColumnWidth - (marginPadding * 2))); 
float inidividualHeight = 
(swatch.Height * (printResolution / swatch.VerticalResolution)) 
» textSize.Height ? 
(swatch.Height * (printResolution / swatch.VerticalResolution)) 
: textSize.Height; 


Bitmap individuallegend - 
new Bitmap(legendWidth, (int)inidividualHeight); 
individuallegend.SetResolution(printResolution, printResolution); 
Graphics g = Graphics.FromImage (individuallegend); 
g.DrawImage (swatch, marginPadding, 0); 
RectangleF textArea - new RectangleF( 
swatchColumnWidth + marginPadding, 0, 
legendWidth - swatchColumnWidth - (marginPadding * 2), 
inidividualHeight); 
g.DrawString(item.Value.Key, stringFont, drawBrush, textArea); 
g.Dispose(); 
legendEntries.Add (individuallegend); 
) 
else ( 
SizeF textSize = graphics.MeasureString(item.Value.Key, stringFont, 
(int) (legendWidth - (marginPadding * 2))); 
float inidividualHeight = textSize.Height; 
Bitmap individuallegend 
new Bitmap(legendWidth, (int)inidividualHeight); 
individuallegend.SetResolution(printResolution, printResolution); 
Graphics g = Graphics.FromImage (individuallegend); 
RectangleF textArea = new RectangleF (marginPadding, 0, 
legendWidth - (marginPadding * 2), inidividualHeight); 
g.DrawString(item.Value.Key, stringFont, drawBrush, textArea); 
g.Dispose(); 
legendEntries.Add (individuallegend); 


Font legendTitleFont - new Font ("Verdana", 10, System.Drawing.FontStyle.Bold); 
SizeF legendTitleArea = graphics.MeasureString (legendTitle, legendTitleFont); 


float currentY - 0; 
// 在 图 例 中 加 入 图 例 名 称 
graphics.DrawString(legendTitle, legendTitleFont, 
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drawBrush, marginPadding, legendEntryPadding); 
currentY += legendTitleArea.Height + marginPadding; 


// 循环 加 入 每 个 图 例 项 
foreach (Bitmap entry in legendEntries) 


t 
if ((currentY + entry.Height) < legendHeight) 


{ 
graphics.DrawImage (entry, 0, currentY); 
currentY += entry.Height + legendEntryPadding; 


) 


legendImage.Save (savePath); 
graphics.Dispose(); 


上 述 代 码 主要 是 利用 .NET 中 GDI+ 绘 制图 例 。 最 后 在 方法 中 加 入 如 下 代码 ， 将 Image 控件 的 
图 片 src 属性 指定 为 刚 保存 的 图 例文 件 : 


string returnstring = savePath; 
CallbackResult cr = new CallbackResult ("image", "legend", 
"image", "Output\\Legend.bmp"); 
map.CallbackResults.Add (cr); 
return map.CallbackResults.ToString(); 


编译 并 运行 程序 ， 可 得 到 如 图 S21 所 示 的 结果 。 


F Untitled Page - Microsoft Internet Explorer 
文件 FF) REO SEV KRA IAW WHW 
地 址 四 ) | 图 http: //1ocalhost/Expor tLegend/ 


北美 地 图 图 例 
C cam. bnd 

C canada 
[mexico 

口 states 


图 5.21 利用 Toc 功能 动态 创建 图 例 


目 吓 义 数 据 源 


在 面向 服务 架构 技术 很 成 熟 的 今天 ， 当 开发 一 个 应 用 系统 时 ， 特 别 是 大 一 点 的 系统 ， 用 
户 一 般 有 集成 其 他 服务 提供 的 数据 的 需求 。 例 如 在 北京 市 开发 地 理 信息 系统 ， 一 般 都 要 求 集 
成 北京 市 测绘 设计 研究 院 提供 的 基础 行政 区 划 图 服务 ， 以 及 北京 市 信息 资源 管理 中 心 提供 的 
逮 感 影像 服务 。 对 于 这 种 需求 ， 在 ArcGIS Server 92 的 开发 中 ， 可 以 通过 自 定义 数据 源 的 方 
式 来 实现 。 

本 章 将 通过 两 个 实例 来 演示 如 何 实现 自 定义 数据 源 。 通 过 本 章 你 将 了 解 到 : 


6.1 自 定义 数据 源 相关 概念 
62 XML 数据 源 
6.3 ”遥感 影像 数据 源 
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6.1 自 定义 数据 源 相 关 概 念 


正如 前 面 多 次 提 到 的 ，Web ADF 通过 在 ESRLARCGIS.ADF.Web.DataSources 中 提供 一 组 抽象 
接口 ,包括 IGISDataSource, IGISResource, IMapResource, IGISFunctionality 等 ， 搭 建 了 一 个 同时 
操作 多 种 数据 源 的 框架 。 并 且 Web ADF 自身 提供 了 ArcGIS Server 数据 源 〈 在 命名 空间 
ESRLARCGIS.ADF.Web.DataSources.ArcGISServer 中 实现 ) ~ ArcIMS 数据 源 、ArcWeb 服务 数据 
源 等 。 在 某 种 意义 上 来 说 ， 这 些 数据 源 也 可 以 称 为 自 定义 数据 源 。 

因此 要 自 定义 数据 源 ， 就 必须 实现 ESRI.ARCGIS.ADF.Web.DataSources 中 一 组 接口 ， 当 然 并 
不 需要 实现 所 有 的 接口 , 可 以 根据 需要 实现 必要 的 接口 即 可 。 例如 对 于 遥感 影像 数据 就 没有 必要 实 
现 IQueryFunctinality。 再 例如 对 于 辅助 数据 源 就 没有 必要 实现 IScaleBarFunctionality 功能 。 

要 自 定 义 数 据 源 ， 最 重要 的 是 要 开明 白 ESRLARCGIS.ADF.Web.DataSources 中 接口 之 间 的 关 
系 。 图 6.1 用 UML 的 形式 表达 了 自 定义 接口 通常 要 实现 的 接口 ， 以 及 这 些 接口 之 间 的 关系 。 


1IGISDataSource 


1 Resources 

LS 
IGISResource | 一 一 IMapResource 

1 Functionalities 

lat 


IGISFunctionality 


IQueryFunctionality IMapFunctionality || IMapTocFunctionality || ITileFunctionality 


图 6.1 自 定义 接口 通常 要 实现 的 接口 之 间 的 关系 


对 于 自 定义 数据 源 ， 当然 源头 是 代表 数据 源 的 IGISDataSource, 该 接口 中 有 一 Resources 属性 ， 
类 型 是 GISResourceCollection, 表示 一 组 资源 的 集合 。 也 就 是 说 数据 源 包含 了 一 组 GIS 资源 。 其 中 
地 图 资源 是 一 种 类 型 的 GIS 资源 ， 也 就 是 说 IMapResource 接口 继承 于 IGISResource。 在 GIS 资源 
接口 中 则 有 一 Functionalities 属性 ， 类 型 是 GISFunctionalityCollection， 表 示 一 组 GIS 功能 的 集合 。 
也 就 是 说 GIS 资源 中 包含 一 组 GIS 功能 。GIS 功能 的 接口 为 IGISFunctionality， 其 派生 接口 包括 绘 
图 功能 IMapFunctionality、 查 询 功 能 IQueryFunctionality, Toc 功能 IMapTocFunctionality 以 及 地 图 
切片 功能 ITileFunctionality 等 。 

因此 对 于 自 定义 数据 源 ， 首 先 要 实现 的 是 IGISDataSource 接口 ， 另 一 个 通常 要 实现 的 是 
IMapResource 接口 ， 实 现 该 接口 意味 着 也 需要 实现 IGISResource 接口 ， 还 有 一 般 也 要 实现 
IMapFunctionality 接口 , 由 于 该 接口 继承 于 IGISFunctionality, 因此 也 意味 着 要 实现 IGISFunctionality 
接口 。 
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6.2.1 数据 格式 


本 实例 要 读 入 的 第 一 种 数据 源 是 XML 格式 的 空间 数据 ， 样 本 数据 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8" ?> 
XREXML version-"1.0"» 
XLAYER id-"1" name-"Trips"» 
XSIMPLERENDERER» 
XSIMPLEMARKERSYMBOL color-"0,255,0" type="star" 
width-"16" outlinecolor-"0,0,0"/» 
«/SIMPLERENDERER» 
«FEATURES» 
XFEATURE featureid-"1"» 
<FIELD name-"SHAPE" type-"-98" > 
XFIELDVALUE» 
XPOINT x-"-117.1" y-"34.0" /> 
«/FIELDVALUE» 
</FIELD> 
<FIELD name="Status" type="12"> 
<FIELDVALUE valuestring="Start Trip" /> 
</FIELD> 
</FEATURE> 
<FEATURE featureid="2"> 
<FIELD name="SHAPE" type="-98" > 
<FIELDVALUE> 
<POINT x="-120.6" y="39.5" /> 
</FIELDVALUE> 
</FIELD> 
<FIELD name="Status" type="12"> 
<FIELDVALUE valuestring="Mid Trip" /> 
</FIELD> 
</FEATURE> 
<FEATURE featureid="3"> 
XFIELD name-"SHAPE" type-"-98" > 


XFIELDVALUE» 
XPOINT x-"-110.5" y-"34.7" /> 

«/FIELDVALUE» 

</FIELD> 

<FIELD name="Status" type="12"> 
<FIELDVALUE valuestring="End Trip" /> 

</FIELD> 

</FEATURE> 


<FEATURE featureid="4"> 
<FIELD name="SHAPE" type="-98" > 
<FIELDVALUE> 
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XPOINT x-"-120.5" y-"44.7" /> 

«/FIELDVALUE» 

</FIELD> 

<FIELD name-"Status" type="12"> 
<FIELDVALUE valuestring-"End Trip" /> 

</FIELD> 

</FEATURE> 
</FEATURES> 
</LAYER> 
</REXML> 


文件 结构 很 简单 ， 每 个 图 层 数据 包含 在 <LAYER> 与 <LAYER 二 标签 之 间 ， 其 中 
SIMPLERENDERER 定义 了 着 色 器 。 每 个 要 素 定义 在 <FEATURE> 与 <FEATURE> 之 间 。 要 素 中 的 
子 项 是 字段 (FIELD) ， 名 称 为 SHAPE 的 字段 表示 为 空间 数据 ， 其 他 字段 表示 属性 数据 。 


6.22 ”实现 数据 源 接口 


在 Visual Studio 2005 中 选择 File 菜单 的 New Project 命令 ， 打 开 如 图 6.2 所 示 的 对 话 框 。 


Hew Project 


Project types: Templates: 
E Visual Basic Visual Studio installed templates 
Windows 


Office | Windons Application 
ii Sart Device G Yindows Control Library EB Console Application 


Database 国 Device Application 国 Excel Workbook 


Start. Kit 
Test ila Ef Outlook Add-in 


由 Visual C# 
E Other Project Types | Ny Templates 
Hj Test Projects [——— 
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ESearch Online Templates. . 


A project for creati 


Hame: [xMLDataSource 


Location: [C: XInetpub'weeroot. 


Solution Name: [CustonDataSource Create directory for solution 


[ OK ] 


图 6.2 本 实例 要 求 创建 一 类 库 


为 了 能 在 多 个 应 用 程序 中 使 用 ， 因 此 模板 选择 创建 Class Library， 即 类 库 ， 将 工程 名 称 设 置 为 
XMLDataSource， 将 解决 方案 名 称 修改 为 CustomDataSource (默认 与 工程 同名 ) 。 我 们 将 在 该 解决 
方案 中 加 入 其 他 工程 。 

在 解决 方案 管理 面板 中 , 将 默认 加 入 的 Classl.cs 文件 名 修改 为 GISDataSource.cs， 编 辑 环境 会 
自动 将 类 名 由 Classl 改变 为 GISDataSource。 我 们 将 利用 该 类 来 实现 IGISDataSource 接口 。 
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为 了 能 利用 Web ADF 中 的 类 库 以 及 NET 中 的 类 库 ， 先 通过 工程 右键 菜单 的 Add Reference 命 
令 ， 加 入 System.Data 、 System Web 、 ESRLArcGIS.ADF 、 ESRIArcGIS.ADF.Web 、 
ESRLArcGIS.ADF.Web.DataSource 以 及 ESRI.ArcGIS.ADF.Web.UI.WebControls 类 库 的 引用 。 

IGISDataSource 接口 需要 实现 的 属性 与 方法 如 图 6.3 所 示 。 有 了 接口 图 ， 对 于 实现 该 接口 就 容 
易 多 了 。 


IGISDataSource 


DataSourceDefinition: System.String 
Identity: System.String 

Initialized: System.Boolean 

Name: System.String 

Page: System. Web.UI.Page 
Resources: GlSResourceCollection 
State: System.Collections.Hashtable 


CreateResource (System.String 
resourceDefinition, System.String name): 
IGISResource 

Dispose: System.Void 

GetAvailableResourceDefinitions 
(System.Type resourceType): 
System.String[] 

Initialize: System. Void 

LoadState (System.Collections.Hashtable 
State): System. Void 

SaveState: System.Collections.Hashtable 


a 
Lal 
S— 
m-m 
a 
a 
BS— 
-— 
-— 
— 
-— 
-— 
-— 


图 63 IGISDataSource 中 的 接口 与 方法 


首先 在 文件 的 头 部 加 入 如 下 命名 空间 的 引用 : 


using System.Collections; 
using System.Web.UI; 
using ESRI.ArcGIS.ADF.Web.DataSources; 


然后 将 类 的 声明 代码 修改 为 如 下 代码 ， 声 明 实 现 IGISDataSource 接口 : 

public class GISDataSource : IGISDataSource 

下 面 需要 做 的 就 是 根据 接口 图 来 实现 接口 。 对 于 属性 比较 好 实现 ， 先 定义 对 应 的 private 类 型 
的 字段 ， 命 名 也 保持 一 致 ， 只 是 将 字段 名 的 第 一 个 字母 改 为 小 写 。 

在 GISDataSource 类 中 加 入 接口 规定 的 属性 对 应 的 字段 ,代码 如 下 每 个 字段 的 意义 见 对 应 属 
性 的 注释 ) : 

private string dataSourceDefinition = string.Empty; 

private string identity = string.Empty; 

bool initialized - false; 

private string name = string.Empty; 

private Page page - null; 

private GISResourceCollection resources = new GISResourceCollection(); 

private Hashtable state; 


然后 加 入 如 下 三 个 构造 方法 : 
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public GISDataSource() { 
} 


public GISDataSource (string name, string dataSourceDefinition) 
: this(name, string.Empty, dataSourceDefinition) { 


} 


public GISDataSource (string name, string identity, 
string dataSourceDefinition) { 
this.name = name; 
this.identity = identity; 
this.dataSourceDefinition = dataSourceDefinition; 


} 


接着 要 实现 的 就 是 IGISDataSource 接口 了 ， 首 先 来 实现 其 属性 。 属 性 的 实现 很 简单 ， 对 于 get 
操作 ， 返 回 对 应 字段 ， 对 于 set， 将 对 应 只 段 设置 为 value 即 可 。 要 注意 的 是 有 些 属 性 是 只 读 的 ， 
因此 没有 set， 而 有 些 属 性 是 只 写 的 ， 没 有 get。 属 性 的 实现 代码 如 下 : 


/// «summary» 
/// GIS 数据 源 的 名 称 
/// «/summary» 
public string Name ( 
get ( 
return name; 
) 
set ( 
name = value; 
} 
} 


/// <summary> 
/// 数据 源 的 定义 信息 ， 通 常 存储 的 数据 源 的 位 置 
/// «/summary» 
public string DataSourceDefinition ( 
get ( 
return dataSourceDefinition; 
) 
set ( 
if (dataSourceDefinition !- value) ( 
dataSourceDefinition - value; 


) 


/// «summary» 
/// 连接 数据 源 的 用 户 身份 
/// «/summary» 
public string Identity { 
get ( 
return identity; 
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对 于 数据 源 接口 的 方法 实现 也 很 简单 ， 代 码 如 下 : 
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/// «summary» 

/// 从 DataSourceManager 控件 维护 的 哈 希 表 中 加 载 状态 

/// </summary> 

/// «param name="state"> 存 储 状态 的 哈 希 表 </param> 

public void LoadState(Hashtable state) ( 
this.state = state; 


} 


/// «summary» 

/// 初始 化 数据 源 

/// </summary> 

public void Initialize() ( 
initialized = true; 

} 

/// <summary> 

/// 保存 状态 

/// </summary> 

/// <returns> 存 储 状态 的 哈 希 表 </param> 

public Hashtable SaveState() { 
return state; 

) 

/// «summary» 

/// 释放 数据 源 

/// </summary> 

public void Dispose() ( 
initialized - false; 
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} 


/// <summary> 
/// 返回 使 用 该 数据 源 的 资源 的 定义 字符 串 
/// </summary> 
public string[] GetAvailableResourceDefinitions (System.Type resourceType) { 
int i = 0; 
string[] definitions - new string[resources.Count]; 
foreach (IGISResource rs in resources) ( 
definitions[i] = rs.ResourceDefinition; 
) 
return definitions; 
) 
/// «summary» 
/// 根据 参数 的 定义 创建 资源 
/// </summary> 
/// «param name="resourceDefinition"> 要 创建 的 资源 的 定义 </param> 
/// <param name="name"> 要 创建 的 资源 的 名 称 </param> 
/// <returns> 参 数 指定 定义 的 GIS 资源 </returns> 
public IGISResource CreateResource(string resourceDefinition, string name) 
i 
throw new Exception ("The method or operation is not implemented."); 


} 
正如 如 上 代码 所 示 ， 对 于 有 些 方法 ， 只 要 不 调用 ， 可 以 不 编写 实现 代码 。 


e 
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这 就 完成 了 数据 源 接口 的 实现 。 第 二 个 要 实现 的 接口 是 IMapResource 接口 。 
6.23 ”实现 地 图 资源 接口 


地 图 资源 接口 负责 与 数据 源 连接 ， 从 数据 源 得 到 数据 ， 并 创建 与 维护 功能 。 
由 于 IMapResource 接口 又 继承 了 IGISResource 接口 ， 所 以 要 实现 地 图 资源 接口 ， 必 须 同 时 实 
现 上 述 两 接口 。 两 个 接口 包含 的 属性 与 方法 如 图 6.4 所 示 。 


IGISResource 


DataSource: IGISDataSource 
Functionalities: GISFunctionalityCollection 
Initialized: System.Boolean 

Name: System.String 

ResourceDefinition: System.String 
ValidationTimeout: System.Int32 


ClearState: System.Void 

CreateFunctionality (System.Type 
functionalityType, System.String 
functionalityName): IGISFunctionality 

Dispose: System.Void 

Initialize: System. Void 

LoadState: System. Void 

SaveState: System. Void 

SupportsFunctionality (System.Type 
functionality Type): System.Boolean 


ma 
na 
m— 
a 
a 
ea 
-— 
-— 
-—- 
-— 
-— 
- 
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IMapResource 


m-a DisplaySettings: 
ESRI.ArcGIS.ADF Web. DisplaySettings 
W—  Mapinformation: IMapInformation 


图 6.4 IMapResource 与 IGISResource 接口 的 属性 与 方法 


在 工程 增加 一 个 类 ， 命 名 为 MapResource。 
在 该 类 声明 代码 之 前 加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web.Display.Graphics; 
using ESRI.ArcGIS.ADF.Web.Display.Drawing; 
using ESRI.ArcGIS.ADF.Web; 

using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.SpatialReference; 
using ESRI.ArcGIS.ADF.Web.DataSources; 
using ESRI.ArcGIS.ADF.Web.Display.Symbol; 
using System.Collections; 

using System.Xml; 


将 MapResource 类 的 声明 修改 为 如 下 代码 ， 增 加 对 地 图 资源 接口 实现 的 声明 : 
public class MapResource : IMapResource 


然后 利用 开发 环境 的 代码 自动 功能 ， 创 建 IMapResource 与 IGISResource 接口 要 实现 的 属性 与 
方法 的 框架 。 通 过 将 光标 移动 到 IMapResource 字符 串 上 ， 在 第 一 个 字母 下 出 现 一 下 划 线 时 ， 将 鼠 
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标 移动 到 该 下 划 线 上 ， 将 出 现 如 图 
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namespace XMLDataSource 


6.5 所 示 的 界面 ,在 其 中 选择 任何 一 项 都 可 实现 自动 生成 代码 框 


interface ESRI. ArcGIS. ADF. Web. DataSources. IMspResource] 


public class lMapResource : source 


public MapResource() 
1 Implement interface 'IlMapResource" 


i 


SE 


J Explicitly implement interface 'IlapResource' 


图 6.5 利用 集成 开发 环境 代码 生成 功能 自动 加 入 接口 需要 实现 的 属性 与 方法 


由 于 有 两 个 接口 需要 实现 ， 因 此 自动 生成 的 代码 利用 region 语句 将 它们 区 分 开 了 。 我 们 可 以 
利用 该 功能 , 将 各 自 要 求实 现 的 属性 的 对 应 字段 放 在 各 个 代码 段 的 开头 , 在 地 图 资源 接口 实现 代码 


段 ， 加 入 如 下 两 个 字段 ， 及 对 应 属性 代码 : 


#region IMapResource Members 


private IMapInformation mapInformation = null; 
private DisplaySettings displaySettings = null; 


/// <summary> 


/// 地 图 信息 ， 例 如 数据 本 身 的 空间 参考 与 范围 等 


/// </summary> 


public IMapInformation MapInformation { 


get { 


return mapInformation; 


) 
set ( 


mapInformation 


) 
) 


/// «summary» 


value; 


/// 地 图 显示 信息 ， 例 如 背景 颜色 、 透 明度 等 


/// </summary> 


public DisplaySettings DisplaySettings ( 


get ( 


return displaySettings; 


) 
set ( 


displaySettings 


) 
) 


#endregion 


value; 


在 GIS 资源 接口 代码 段 加 入 该 接口 规定 要 实现 的 属性 ， 及 其 对 应 字段 : 
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在 上 述 代码 中 ， 加 入 了 一 个 图 形 数据 集 类 型 的 字段 graphics， 我 们 用 该 字段 存放 数据 源 对 应 的 
数据 。 

下 面 要 实现 的 是 GIS 资源 接口 的 方法 。 该 接口 最 先 执行 的 是 资源 初始 化 Initialize 方法 ， 在 该 
方法 中 ， 需 要 从 数据 源 中 读 入 数据 。 该 方法 的 代码 如 下 : 


) 
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if (mapInformation == null) ( 


graphics = new GraphicsDataSet () ; 
string dataSourceConfig = DataSource.DataSourceDefinition; 
ProcessXML (dataSourceConfig); 


mapInformation - new MapInformation (graphics); 
if (DisplaySettings !- null) 
graphics.ImageDescriptor - displaySettings.ImageDescriptor; 


initialized = true; 


在 上 面 的 代码 中 ， 首 先 利用 ProcessXML 方法 从 数据 源 对象 的 DataSourceDefinition 属性 指定 
的 文件 中 读 入 数据 。 然 后 根据 图 形 数据 ， 创 建 一 个 地 图 信息 对 象 。 该 MapInformation 是 本 实例 在 
后 面 要 实现 的 。 

ProcessXML 方法 的 代码 如 下 : 


private void ProcessXML (string dataSourceConfig) { 


null; 


try { 


// 从 文件 中 读 入 XML 数据 

XmlDocument doc = new XmlDocument(); 
doc.Load (dataSourceConfig); 

XmlNode root - doc.DocumentElement; 


// 得 到 图 层 信息 

XmlNode layerNode = root.SelectSingleNode ("LAYER"); 

string layername = layerNode.Attributes.GetNamedItem("name").Value; 
string layerid - layerNode.Attributes.GetNamedItem("id").Value; 


// 创建 图 形 图 层 用 于 存储 要 素 
ESRI.ArcGIS.ADF.Web.Display.Graphics.ElementGraphicsLayer glayer = 


glayer = 
new ESRI.ArcGIS.ADF.Web.Display.Graphics.ElementGraphicsLayer(); 
glayer.TableName = layername; 


// 读 着 色 器 信息 

XmlNode rendererNode = layerNode.SelectSingleNode ("SIMPLERENDERER") ; 

XmlNode markerNode = 
rendererNode.SelectSingleNode ("SIMPLEMARKERSYMBOL") ; 

string markercolor - 
markerNode.Attributes.GetNamedItem("color").Value; 

string markertype - markerNode.Attributes.GetNamedItem("type").Value; 

string markerwidth = 
markerNode.Attributes.GetNamedItem("width").Value; 

string markeroutlinecolor = 
markerNode.Attributes.GetNamedItem("outlinecolor").Value; 


// 创建 符号 
SimpleMarkerSymbol sms = new SimpleMarkerSymbol(); 
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string[] markerrgb = markercolor.Split(','); 
int markerr = Int32.Parse (markerrgb[0]); 
int markerg = Int32.Parse (markerrgb[1]); 
int markerb = Int32.Parse (markerrgb[2]1); 
sms.Color = System.Drawing.Color.FromArgb(markerr, markerg, markerb); 
switch (markertype) ( 
case "circle": 
sms.Type - MarkerSymbolType.Circle; 
break; 
case "square": 
sms.Type - MarkerSymbolType.Square; 
break; 
case "triangle": 
sms.Type - MarkerSymbolType.Triangle; 
break; 
case "star": 
sms.Type = MarkerSymbolType.Star; 
break; 
default: 
break; 
) 
int markerwidthInt; 
if (!Int32.TryParse (markerwidth, out markerwidthInt)) { 
markerwidthInt - 10; 
) 
sms.Width = markerwidthInt; 
string[] markeroutrgb = markeroutlinecolor.Split(',"); 
int markeroutr = Int32.Parse (markeroutrgb[0]); 
int markeroutg Int32.Parse (markeroutrgb[1]); 
int markeroutb Int32.Parse (markeroutrgb[2]); 
sms.OutlineColor = 
System.Drawing.Color.FromArgb (markeroutr, markeroutg, markeroutb); 


SI9 98M 


// 读 要 素 信 息 
XmlNode featuresNode = layerNode.SelectSingleNode ("FEATURES"); 
XmlNodeList featureNodes = featuresNode.SelectNodes ("FEATURE"); 


// 读 图 形 信息 ， 并 创建 图 形 对 象 
for (int t = 0; t < featureNodes.Count; ++t) { 
XmlNodeList flds = featureNodes[t].SelectNodes ("FIELD"); 
for (int 3 = 0> 3 < flds?Ccountz stt) 
if (flds[s].Attributes["name"].Value == "SHAPE") { 
XmlNodeList fldvalues = 
flds[s].SelectSingleNode ("FIELDVALUE").ChildNodes; 
if (fldvalues.Count < 1) { 
break; 
) 
else if (fldvalues.Count == 1) { 
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XmlNode fldvalue = fldvalues[0]; 
if (fldvalue.Name == "POINT") { 
double dx = 
Double.Parse(fldvalue.Attributes["x"].Value); 
double dy = 
Double.Parse(fldvalue.Attributes["y"].Value); 


Point point = new Point (dx, dy); 
GraphicElement ge = new GraphicElement (point, sms); 
glayer.Add (ge); 
) 
} 
else if (fldvalues.Count > 1) {} 


} 


graphics.Tables.Add (glayer); 
} 


catch (Exception ex) { 
throw new Exception ("异常 : 不 能 加 载 XML XE" + ex.Message); 


} 
} 


上 述 方法 就 是 利用 处 理 XML 文档 的 类 ， 比 如 XmlDocument、XmlNode 等 ， 解 析 62.1 节 中 给 
出 的 文件 内 容 ， 并 根据 图 形 信息 创建 图 形 对 象 。 

GIS 资源 接口 中 另 两 个 重要 方法 是 SupportsFunctionality 与 CreateFunctionality。 前 者 用 于 判断 
资源 是 否 支持 某 种 类 型 的 功能 。 该 方法 的 代码 如 下 : 

public bool SupportsFunctionality(System.Type functionalityType) { 

if (functionalityType == typeof (IMapFunctionality)) 
return true; 

else if (functionalityType == typeof (IMapTocFunctionality)) 
return true; 

else 
return false; 

) 

上 述 代 码 表示 ， 本 资源 只 支持 绘图 功能 与 Toc 功能 。 

CreateFunctionality 方法 用 于 创建 某 种 类 型 的 功能 ， 由 于 本 实例 的 资源 只 支持 绘图 功能 与 Toc 
功能 ， 因 此 针对 该 两 种 类 型 ， 分 别 利用 new 来 创建 两 个 功能 类 的 实例 。 这 两 个 功能 类 就 是 我 们 在 
随后 章节 要 实现 的 。 该 方法 的 代码 如 下 : 

public IGISFunctionality CreateFunctionality (System.Type functionalityType, 


string functionalityName) 


t 


IGISFunctionality func = null; 
if (functionalityType == typeof(IMapFunctionality)) ( 
func = new MapFunctionality(functionalityName, this); 


) 
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else if (functionalityType == typeof (IMapTocFunctionality)) ( 
func = new MapTocFunctionality(functionalityName, this); 

) 

else ( 
throw new ArgumentException ("functionalityType"); 

) 

return func; 


j 
GIS 资源 接口 中 另 一 大 类 的 方法 是 用 于 状态 的 管理 。LoadState 方法 用 于 从 数据 源 存储 的 状态 
中 加 载 数据 ， 代 码 如 下 : 


public void LoadState() ( 
if (dataSource -- null) 
return; 
if (dataSource.State == null) 
return; 


object o = dataSource.State[key]; 

if (o != null) ( 

MapResource mr - o as MapResource; 
graphics - mr.graphics; 
mapInformation - mr.mapInformation; 
displaySettings - mr.displaySettings; 


) 
而 SaveState 用 于 在 数据 源 中 保存 当前 资源 的 状态 。 代 码 如 下 : 


public void SaveState() ( 
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if (dataSource == null) 
return; 

if (dataSource.State == null) 
return; 


dataSource.State[key] = this; 
) 


ClearState 方法 用 于 清除 资源 的 状态 ， 代 码 如 下 : 


public void Clearstate() { 
this.graphics = null; 
this.mapInformation = null; 
this.displaySettings - null; 
) 


最 后 一 个 方法 是 Dispose, 用 于 销毁 该 资源 , 对 于 我 们 , 只 需要 简单 地 将 初始 化 标志 设置 为 false 
即 可 ， 代 码 如 下 : 


public void Dispose() { 
initialized = false; 


H 
至 此 就 完成 了 地 图 资源 的 实现 。 下 一 步 要 实现 的 是 绘图 功能 。 


6.24 ”实现 绘图 功能 
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顾名思义 ， 绘 图 功能 要 实现 的 主要 就 是 生成 一 张 地 图 图 片 。 


由 于 IMapFunctionality 接口 又 继承 了 IGISFunctionaltiy 接口 ， 所 以 对 于 要 实现 绘图 功能 接口 ， 


也 必须 同时 实现 上 述 两 接口 。 两 个 接口 包含 的 属性 与 方法 如 图 65 所 示 。 


IGISFunctionality 


IMapFunctionality 


DisplaySettings: 
ESRI.ArcGIS.ADF.Web.DisplaySettings 

MaintainsState: System.Boolean 

Rotation: System.Double 

SpatialReference: 
ESRI.ArcGIS.ADF.Web.SpatialReferenc 
e.SpatialReference 

Units: Units 


Initialized: System.Boolean 

Name: System.String 

Resource: IGISResource 

WebControl 
System.Web.UI.WebControls WebContr 
ol 


在 工程 中 新 加 一 个 类 ， 命 名 为 MapFunctionality。 


using 
using 
using 
using 
using 
using 
using 


将 MapFunctionality 类 的 声明 修改 为 如 下 代码 ， 增 加 对 绘图 功能 接口 实现 的 声明 : 


Dispose: System.Void 


Initialize: System.Void 

LoadState: System. Void 

SaveState: System. Void 

Supports (System.String operation): 
System.Boolean 


ApplyStateToDataSourceObjects: 
System. Void 

DrawExtent 
(ESRLArcGIS.ADF.Web.Geometry.Envel 
ope extentToDraw): 
ESRI.ArcGIS.ADF.Web.Maplmage 

GetCopyrightText: 
System.Collections.Generic.Dictionary 

GetLayers (out System.String[]& layerlDs, 
out System.String[J& layerNames): 
System.Void 

GetLayerVisibility (System.String layerlD): 
System.Boolean 

GetScale 
(ESRLArcGIS.ADF.Web.Geometry.Envel 
ope extent, System.Int32 mapWidth, 
System.Int32 mapHeight): 
System.Double 

GetStateFromDataSourceObjects: 
System.Void 

GetVisibleScale (System.String layerlD, out 
System.Double& minScale, out 
System.Double& maxScale): 
System. Void 

SetLayerVisibility (System.String layerlD, 
System.Boolean visible): System. Void 


Fd6.5 IMapFunctionality 与 IGISFunctionaltiy 接口 的 属性 与 方法 


System.Collections; 


ESRI.ArcGIS.ADF.Web.Geometry; 


ESRI.ArcGIS.ADF.Web.SpatialReference; 


ESRI.ArcGIS.ADF.Web.DataSources; 


ESRI.ArcGIS.ADF.Web.Display.Graphics; 
ESRI.ArcGIS.ADF.Web.Display.Drawing; 


ESRI.ArcGIS.ADF.Web; 


class MapFunctionality : IMapFunctionality 


利用 集成 开发 环境 的 自动 生成 代码 功能 , ^E IX IMapFunctionality 接口 代码 框架 。 接着 在 绘图 功 
能 接口 代码 段 ， 加 入 其 要 求实 现 的 属性 ， 代 码 如 下 : 


在 其 中 先 加 入 如 下 命名 空间 的 引用 : 
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接着 在 IGISFunctionality 接口 代码 段 ， 加 入 其 要 求 的 属性 的 实现 代码 ， 代 码 如 下 : 
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接着 在 MapFunctionaltiy 类 代码 段 ， 加 入 如 下 代码 : 
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H 
else { 
MapResource mr = MapResource; 
if (mr != null && mr.Graphics !- null) ( 
graphics - mr.Graphics.Clone(); 
) 
return graphics; 
} 
} 
) 
} 
private string key { 
get { 
string szResource = resource.GetType ().ToString() * ":" + resource.Name; 


string szThis = this.GetType().ToString() + ":" + name; 


return (szResource + "," + szThis); 


) 

在 上 面 的 代码 段 中 ， 利 用 graphicsDataSet. 字段 存储 数据 源 的 图 形 数据 ， 在 其 对 应 的 属性 代码 
中 ， 首 先 查 询 功 能 是 否 保存 状态 ， 如 果 不 保存 状态 ， 则 从 对 应 的 地 图 资源 中 获取 图 形 数据 ， 如 果 保 
存 状 态 ， 但 是 图 形 数据 不 存在 时 ， 从 地 图 资源 中 拷贝 图 形 数据 。 

绘图 功能 接口 中 GetLayer Visibility 方法 和 Set Louyer Visibility 方法 用 于 控制 图 层 的 可 见 性 ， 
其 中 GetLayerVisibility 方法 用 于 得 到 某 个 图 层 的 可 见 性 ， 代 码 如 下 : 

public bool GetLayerVisibility(string layerID) ( 

return getLayer (layerID).Visible; 
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} 


private GraphicsLayer getLayer(string layerID) { 
GraphicsLayer  graphicslayer =  GraphicsDataSet.Tables[layerID] as 
GraphicsLayer; 
return graphicslayer; 


) 
SetLayerVisibility 方法 用 于 设置 图 层 的 可 见 性 ， 实 现代 码 如 下 : 


public void SetLayerVisibility(string layerID, bool visible) ( 


getLayer(layerID).Visible = visible; 


} 
DrawExtent 当然 是 绘图 功能 接口 中 最 重要 的 方法 了 ， 该 方法 用 于 绘制 地 图 。 在 本 实例 中 ， 直 
接 调用 GraphicsDataSet 类 的 DrawExtent 方法 即 可 实现 绘制 地 图 。 代 码 如 下 : 


public ESRI.ArcGIS.ADF.Web.Maplmage DrawExtent 
(ESRI.ArcGIS.ADF.Web.Geometry.Envelope extentToDraw) { 


if (GraphicsDataSet != null) ( 


ApplyStateToDataSourceObjects(); 
return GraphicsDataSet.DrawExtent (extentToDraw); 
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) 
else 


return null; 
) 
在 绘图 功能 接口 中 ， 还 有 一 类 方法 用 于 获取 与 应 用 状态 ， 其 中 ApplyStateToDataSourceObjects 
方法 用 于 将 更 新 的 状态 应 用 于 地 图 资源 。 本 实例 实现 代码 如 下 : 
public void ApplyStateToDataSourceObjects() { 
if (GraphicsDataSet != null) { 


if (DisplaySettings !- null) 
GraphicsDataSet.ImageDescriptor - DisplaySettings.ImageDescriptor; 


) 
GetStateFromDataSourceObjects 过 程 正好 相反 ， 从 地 图 资源 中 得 到 状态 信息 。 实 现代 码 如 下 : 


public void GetStateFromDataSourceObjects() { 
if (GraphicsDataSet != null) ( 
if (DisplaySettings != null) 
DisplaySettings.ImageDescriptor = GraphicsDataSet.ImageDescriptor; 


} 

对 于 本 实例 ， 
码 ， 而 不 需要 修改 。 

下 面 要 实现 的 是 GIS 功能 接口 的 方法 。GIS 功能 接口 中 一 类 方法 用 于 维护 状态 ， 其 中 方法 
LoadState 用 于 根据 不 同 设置 从 不 同 对 象 中 加 载 状态 信息 ， 详 细 信 息 见 实现 如 下 代码 : 


要 利用 绘图 功能 接口 中 的 其 他 方法 , 因此 可 直接 保留 集成 开发 环境 生成 的 代 


public void LoadState() ( 
if (resource -- null || resource.DataSource -- null 
11 resource.DataSource.State -- null) ( 
throw new Exception ("资源 无 效 "); 
) 


// 如 果 状 态 保存 过 ， 则 加 载 以 前 的 状态 
object o = resource.DataSource.State[key]; 
if (o !— null) { 
MapFunctionality mf = o as MapFunctionality; 
// 从 保存 的 状态 中 得 到 属性 
this.maintainsState = mf.MaintainsState; 
this.webControl = mf.WebControl; 
this.spatialReference = mf.spatialReference; 
// 如 果 维 护 状 态 ， 则 加 载 本 功能 自身 保存 的 状态 
if (maintainsState) ( 
displaySettings = mf.displaySettings; 
graphics - mf.graphics; 


} 
// 从 数据 源 对 象 中 得 到 共享 属性 ， 这 些 属性 将 依据 数据 源 对 象 初始 化 
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GetStateFromDataSourceObjects () 
} 


SaveState 方法 用 于 在 资源 中 保存 状态 。 实 现代 码 如 下 : 


public void SaveState() { 


if (resource == null) 
return; 
if (resource.DataSource == null) 
return; 
if (resource.DataSource.State == null) 
return; 
ApplyStateToDataSourceObjects(); 
resource.DataSource.State[key] = this; 


} 

GIS 功能 接口 中 另 一 类 方法 用 于 初始 化 与 销毁 对 象 ， 分 别 对 应 Initialize 与 Dispose 方法 。 实 现 
代码 如 下 : 

public void Initialize() ( 


initialized - true; 


) 


public void Dispose() ( 
initialized - false; 
) 
接口 中 最 后 一 个 方法 是 Supports， 该 方法 用 于 判断 本 功能 对 象 是 否 支 持 某 类 操作 。 由 于 本 实例 
不 准备 实现 计算 比例 尺 功能 ， 因 此 对 于 该 操作 ， 返 回 false， 表 示 不 支持 。 对 于 其 他 操作 ， 则 返回 
true。 实 现代 码 如 下 : 
public bool Supports(string operation) { 
if (operation -- "GetScale") 
return false; 


return true; 


) 
至 此 实现 了 绘图 功能 。 下 面 要 实现 的 是 Toc 功能 。 


6.2.5 实现 Toc 功能 


Toc 功能 就 是 要 支持 在 Toc 控件 中 操纵 对 应 的 地 图 资源 ， 例 如 设置 图 层 的 可 见 性 。 

同 绘图 功能 一 样 ，IMapTocFunctionality 接口 继承 与 IGISFunctionality 接口 ， 因 此 要 实现 
IMapTocFunctionality 接口 ， 也 必须 同时 实现 IGISFunctionality 接口 。IMapTocFunctionality 接口 要 
求实 现 的 属性 与 方法 如 图 6.6 所 示 。 
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IMapTocFunctionality 


-4— GetMapContents (System.String 
mapFunctionalityName, 
ESRLArcGIS.ADF Web.WeblmageForm 
at format, System.Boolean 
useMimeData, System.Boolean 
showAllDataFrames): 

ESRI.ArcGIS.ADF Web.TocDataFrame[] 


图 6.6 IMapTocFunctionality 接口 的 属性 与 方法 


在 工程 中 新 加 一 个 类 ， 命 名 为 MapTocFunctionality。 在 其 中 先 加 入 如 下 命名 空间 的 引用 : 


using 
using 
using 
using 
using 
using 
using 


System.Collections; 


ESRI 
ESRI 
ESRI 
ESRI 
ESRI 
ESRI 


-ArcGIS 
-ArcGIS. 
-ArcGIS. 
-ArcGIS. 
-ArcGIS. 
-ArcGIS 


-ADF.Web.Geometry; 
ADF.Web.SpatialReference; 
ADF.Web.DataSources; 
ADF.Web.Display.Graphics; 
ADF.Web.Display.Drawing; 
-ADF.Web; 


将 MapTocFunctionality 类 的 声明 修改 为 如 下 代码 ， 增 加 对 Toc 功能 接口 实现 的 声明 : 


class MapTocFunctionality: IMapTocFunctionality 


利用 集成 开发 环境 的 自动 生成 代码 功能 ， 生 成 IMapTocFunctionality 接口 代码 框架 。 由 于 Toc 
功能 接口 中 没有 定义 属性 ， 因 此 直接 在 GIS 功能 接口 代码 段 ， 加 入 其 要 求实 现 的 属性 与 方法 ， 代 


码 如 下 : 


#region IGISFunctionality Members 
private string name = string.Empty; 
private IGISResource resource - null; 
private bool initialized - false; 
private MapResource mapResource; 
System.Web.UI.WebControls.WebControl webControl; 
public System.Web.UI.WebControls.WebControl WebControl { 
get ( 
return webControl; 
) 
set ( 
webControl - value; 


public string Name ( 
get ( 
return name; 
) 
set { 
name — value; 
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对 于 Toc 功能 来 说 要 求实 现 的 功能 相对 要 少 ， 因 此 其 GIS 功能 接口 实现 代码 也 相对 简单 。 
在 MapTocFunctionality 类 自身 代码 段 中 ， 加 入 如 下 代码 : 
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接着 要 实现 的 是 Toc 功能 接口 的 方法 。Toc 功能 接口 只 规定 了 一 个 方法 ， 用 于 返回 一 个 
TocDataFrame 数组 。 实 现 方法 如 下 : 


public TocDataFrame[] GetMapContents (string mapFunctionalityName, 
WebImageFormat format, bool useMimeData, bool showAllDataFrames) 
t 
TocDataFrame[] tocDataFrames - new TocDataFrame[1]; 
tocDataFrames[0] = new TocDataFrame (resource.Name); 
System.Web.SessionState.HttpSessionState session - null; 
try ( 
System.Web.HttpContext httpContext = System.Web.HttpContext.Current; 
if (httpContext != null) 
session - httpContext.Session; 
) 
catch ( 
) 


SwatchInfo swatchInfo = new SwatchInfo(10, 10, session); 
foreach (System.Data.DataTable table in mapResource.Graphics.Tables) ( 
tocDataFrames[0].Add(GraphicsLayer.GetTocLayer (table as GraphicsLayer, 
swatchInfo)); 
} 


return tocDataFrames; 


} 
至 此 实现 了 Toc 功能 。 


6.26 ”实现 地 图 信息 接口 


最 后 要 实现 的 是 IMapInformation 接口 。 该 接口 提供 只 要 求实 现 一 些 属性 ， 如 图 6.7 所 示 。 


IMapinformation 


W—  DataFrame: System.String 
DefaultExtent: 
ESRI.ArcGIS.ADF.Web.Geometry.Envel 


ope 

DefaultSpatialReference: 
ESRIArcGIS.ADF Web.SpatialReferenc 
e.SpatialReference 


H— 

BS— 

W— FullExtent: 
ESRIArcGIS.ADF.Web.Geometry.Envel 

Lu 


ope 
TileCachelnfo: TileCachelnfo 


图 6.7 IMapInformation 接口 要 求实 现 的 属性 


在 工程 中 新 加 一 个 类 ， 命 名 为 MapInformation。 在 其 中 先 加 入 如 下 命名 空间 的 引用 : 


using System.Collections; 
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using ESRI.ArcGIS.ADF.Web.DataSources; 
using ESRI.ArcGIS.ADF.Web.Display.Graphics; 
using ESRI.ArcGIS.ADF.Web.Display.Drawing; 
using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.SpatialReference; 


将 MapInformation 类 的 声明 修改 为 如 下 代码 ， 增 加 对 IMaplInformation 接口 实现 的 声明 : 
class MapInformation: IMapInformation 
该 类 的 实现 很 简单 ， 代 码 如 下 所 示 : 


private GraphicsDataSet graphics = null; 


public MapInformation (GraphicsDataSet graphics) { 
this.graphics = graphics; 


#region IMapInformation Members 


private string dataFrame = string.Empty; 
private SpatialReference defaultSpatialReference = null; 
private TileCacheInfo tileCacheInfo = null; 


public string DataFrame ( 
get ( 
return dataFrame; 
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public SpatialReference DefaultSpatialReference { 
get { 
return 
defaultSpatialReference; 


public Envelope DefaultExtent { 
get { 
if (graphics == null) 
return null; 
else 
return graphics.DefaultExtent; 


public Envelope FullExtent ( 
get ( 
if (graphics -- null) 
return null; 
else 
return graphics.FullExtent; 
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} 


public TileCacheInfo TileCacheInfo ( 
get ( 
return tileCacheInfo; 
) 
set ( 
tileCacheInfo - value; 
) 
) 


#endregion 


6.2.7 ”注册 自 定义 数据 源 


在 地 图 资源 管理 器 控件 的 MapResourcesItem 属性 设置 对 话 框 的 Map Resource Definition Editor 
工具 中 ，Web ADF 已 经 内 置 了 几 个 数据 源 类 型 ， 在 Type 选项 中 有 GraphicsLayer、ArcGIS Server 
Local, OGC (WMS) Service, ArcIMS, ArcGIS Server Internet, ArcWeb Services 这 几 种 类 型 可 以 选 
择 。 不 过 现在 要 显示 自 定义 的 XML 数据 源 ， 就 需要 为 注册 新 的 一 个 数据 源 类 型 来 实现 。 

在 MapResourcesItem 属性 设置 对 话 框 的 Map Resource Definition Editor 工具 中 的 DataSource 类 
型 , 是 通过 一 个 配置 文件 来 实现 的 , 在 ArcGIS.Server 9.2 Net 中 这 些 配置 文件 放置 在 ArcGIS Server 
安装 目录 的 DotNet 文件 内 ， 这 里 能 找到 ArcGIS Server Local、GraphicsLayer、ArcIMS 等 所 有 
DataSource 类 型 的 配置 文件 。 这 些 都 是 文本 文件 , 因此 读者 可 以 用 记事 本 打 这 些 文件 学 习 一 下 它 是 
如 何 构成 的 。 在 DotNet 文件 夹 内 添加 一 个 名 为 ESRI.ArcGIS.ADF.Web.DataSources.XMLData.config 
的 配置 文件 ， 注 册 我 们 自 定 义 的 数据 源 。 注 意 该 文件 名 前 面 必 须 为 
ESRI.ArcGIS.ADF.Web.DataSources。 文 件 所 包含 的 具体 内 容 和 说 明 如 下 : 


<?xml version-"1.0" encoding-"utf-8" ?> 
«DataSources» 
<!-- 数 据 源 类 型 的 名 称 --> 
<DataSource name="XML Data"> 
<!-- 数 据 源 处 理 类 库 名 以 及 数据 源 处 理 类 --> 
«Implementation assembly-"XMLDataSource" 
class-"XMLDataSource.GISDataSource"» 
«/Implementation» 
XIdentityEditorForm assembly-"ESRI.ArcGIS.ADF.Web.UI.WebControls" 
class-"ESRI.ArcGIS.ADF.Web.UI.WebControls.Design.Un 
usedPropertyEditor"» 
«/IdentityEditorForm» 
<! 一 -数据 源 属性 编辑 器 定义 --> 
<DefinitionEditorForm assembly="" class=""></DefinitionEditorForm> 
<Resource type="Map"> 
<DefinitionEditorForm assembly="" class=""></DefinitionEditorForm> 
<! 一 地 图 资源 处 理 库 名 以 及 地 图 资源 处 理 类 -> 
<Implementation assembly-"XMLDataSource" 
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class="XMLDataSource.MapResource"> 
</Implementation> 
</Resource> 
</DataSource> 
</DataSources> 


6.2.8 测试 自 定义 XML 数据 源 功 能 


为 了 验证 类 库 是 否 成 功 ， 我 们 创建 一 个 简单 的 Web 应 用 程序 来 测试 。 

利用 File 菜单 的 Add 子 菜单 的 New Web Site 命令 ， 在 当前 解决 方案 中 增加 一 个 站 点 。 将 其 命 
名 为 CutomDataSourceTest。 

在 Default.aspx 页 面 中 增加 一 地 图 资源 管理 器 控件 、 一 地 图 控件 与 一 Toc 控件 。 打 开 地 图 资源 
管理 器 控件 的 MapResourcesItem 属性 设置 对 话 框 ， 在 其 中 先 添加 一 地 图 资源 ， 然 后 通过 Definition 
属性 ， 打 开 Map Resource Definition Editor 对 话 框 。 这 时 在 数据 源 类 型 的 下 拉 列 表 框 中 有 了 我 们 在 
62.7 节 中 注册 的 XML Data 数据 源 类 型 (如 图 6.8 所 示 ) 。 选 择 该 类 型 。 然 后 将 DataSource 设置 为 
我 们 在 6.2.1 节 中 文件 保存 的 路 径 。 


Nap Resource Definition Editor 


Map Resource Definition Editor 
Choose a type from the list. Click to enter details for data source, 
identity and resource. 


s 
G 
fal 
un 


Ine 


Data Source: 


ArcGIS Server Internet 
ArcWeb Services 


图 6.8 添加 自 定义 数据 源 


然后 再 添加 USAMap 地 图 资源 。 

由 于 我 们 需要 利用 XMLDataSource 类 库 来 处 理 XML Data 类 型 的 数据 集 ， 因 此 需要 在 工程 中 
加 入 该 类 库 对 应 的 动态 连接 库 。 一 个 方法 是 从 XMLDataSource 工程 的 bin 目录 下 拷贝 到 本 工程 的 
bin 目录 下 。 另 一 个 更 好 的 方法 是 直接 加 入 XMLDataSource 工程 引用 。 可 以 通过 工程 的 右键 菜单 的 
Add Reference 命令 ， 打 开 Add Reference 对 话 框 ， 切 换 到 Project 选项 卡 中 ， 如 图 6.9 所 示 。 集 成 开 
发 环境 已 经 将 本 解决 方案 中 的 其 他 工程 列 出 了 ， 只 需要 选择 即 可 。 这 样 一 来 ， 当 修改 了 
XMLDataSource 类 库 后 , 集成 开发 环境 将 最 新 的 类 库 自动 拷贝 到 本 工程 的 bin 目录 下 , 而 不 需要 每 
次 都 人 工 操作 。 


Add Reference 


pe 
.NET |COM |Projects [Browse | Recent 


Project Name ^ Project Directory 
XMLD S ce C:\Inetpub\wwwroot\ 


图 6.9 将 另 一 工程 作为 引用 加 入 本 工程 


编译 并 运行 程序 ， 程 序 运 行 效果 如 图 6.10 所 示 ，4 个 五 角 星 是 来 自 XML 类 型 的 数据 ， 表 明 自 
定义 数据 源 成 功 。 


F Untitled Page - Microsoft Internet Explorer [£yys) 
O SAO SEV KEAN IAW 帮助 00 
HIEM) Æ) http://localhost/CustomDataSource/CustomDataSourceTest/Default. «V. 转 到 


s 加 XMLData 
[z Trips 
uiis 日 [Z/USAMap 
(z ushigh 
* [states 
a [7 counties 


图 6.10 在 地 图 控件 中 显示 自 定义 的 数据 源 


6.3 ”遥感 影像 数据 源 


在 前 面 的 章节 中 我 们 介绍 的 都 是 矢量 要 素 图 层 的 操作 。 而 在 一 个 实际 的 地 理 信息 系统 中 , 通常 
需要 用 栅 格 的 图 像 作为 背景 。 在 本 节 中 我 们 将 通过 把 Virtual Earth 地 图 图 片 数据 作为 数据 源 ， 直 接 
使 用 MicroSoft 的 卫星 遥感 影像 作为 系统 的 背景 。 

本 实例 由 于 使 用 了 地 图 切片 ， 因 此 需要 实现 ITileFunctionality 接口 ， 在 实现 该 接口 中 的 类 中 从 
Virtual Earth 地 图 图 片 网 站 得 到 图 片 即 可 。 

在 使 用 地 图 切片 技术 时 ,地 图 切片 的 信息 存储 在 IMapInformation 接口 的 TileCacheInfo 属性 中 。 
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地 图 切片 信息 对 象 的 LodInfos 属性 存储 了 一 组 LOD (Level Of Details， 多 细节 等 级 ) 对 象 。 这 些 


接口 与 类 的 关系 如 图 6.11 所 示 ， 弄 清楚 它们 之 间 的 关系 是 使 用 地 图 切片 技术 的 关键 。 


IMapResource 
1 Maplnformation 
1.* 
IMapinformation 
1 TileCachelnfo 

1 
TileCachelnfo 
1 Lodinfos 
Tot 
Lodinfo 


图 6.11 地 图 切片 使 用 的 相关 接口 与 类 及 其 相互 之 间 的 关系 


利用 File 菜单 的 Add 子 菜单 的 New Project 命令 ,在 CustomDataSource 解决 方案 中 增加 一 类 库 


类 型 的 工程 ， 将 其 命名 为 TiledMapDataSource。 


通过 工程 右键 菜单 的 Add Reference 命令 ， 加 入 System.Data, System.Web, ESRI.ArcGIS.ADF, 
ESRIArcGIS.ADF.Web、ESRIArcGIS.ADF.Web .DataSource 以 及 ESRIArcGIS.ADF.Web.ULWebControls 


类 库 的 引用 。 
6.3.1 实现 数据 源 接口 


将 新 建 工 程 时 默认 加 入 的 Classl.cs 文件 重新 命名 为 GISDataSource.cs。 
在 该 类 声明 代码 之 前 ， 加 入 如 下 命名 空间 的 引用 : 


using System.Web.UI; 
using System.Collections; 
using ESRI.ArcGIS.ADF.Web.DataSources; 


修改 类 声明 代码 ， 加 入 实现 IGISDataSource 接口 的 声明 : 


public class GISDataSource : IGISDataSource 


利用 集成 开发 环境 的 代码 生成 功能 ， 创 建 IGISDataSource 接口 要 求实 现 的 属性 与 方法 的 代码 


框架 ， 将 代码 修改 为 : 


#region IGISDataSource Members 


private string dataSourceDefinition = string.Empty; 

private string identity = string.Empty; 

bool initialized - false; 

private string name = string.Empty; 

private Page page - null; 

private GISResourceCollection resources = new GISResourceCollection(); 
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/// «/summary» 

/// <returns> 存 储 状 态 的 哈 希 表 </param> 

public Hashtable SaveState() { 
return state; 


/// «summary» 

/// 释放 数据 源 

/// </summary> 

public void Dispose() { 
initialized = false; 


/// <summary> 
/// 返回 使 用 该 数据 源 的 资源 的 定义 字符 串 
/// </summary> 
public string[] GetAvailableResourceDefinitions (System.Type resourceType) { 
int i = 0; 
string[] definitions = new string [resources .Count]; 
foreach (IGISResource rs in resources) { 
definitions[i] = rs.ResourceDefinition; 


return definitions; 


/// «summary» 

/// 根据 参数 的 定义 创建 资源 

/// </summary> 

/// <param name="resourceDefinition"> 要 创建 的 资源 的 定义 </param> 

/// <param name="name"> 要 创建 的 资源 的 名 称 </param> 

/// <returns> 参 数 指定 定义 的 GIS 资源 </returns> 

public IGISResource CreateResource(string resourceDefinition, string name) 
{ 


throw new Exception("The method or operation is not implemented."); 


#endregion 


然后 加 入 GISDataSource 类 的 几 个 构造 方法 ， 代 码 如 下 : 


public GISDataSource() { 
} 


public GISDataSource (string name, string dataSourceDefinition) : 
this (name, string.Empty, dataSourceDefinition) { 


public GISDataSource (string name, string identity, 
string dataSourceDefinition) { 
this.name = name; 
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this.identity = identity; 
this.dataSourceDefinition - dataSourceDefinition; 


ii 
通常 GIS 数据 源 接口 的 实现 类 并 没有 多 少 功能 ， 主 要 是 定义 数据 来 源 的 位 置 。 


6.32 ”实现 地 图 资源 接口 


在 工程 增加 一 个 类 ， 命 名 为 MapResource. 
在 该 类 声明 代码 之 前 加 入 如 下 命名 空间 的 引用 : 
using System.Web.UI; 

using System.Collections; 


using ESRI.ArcGIS.ADF.Web.DataSources; 
using ESRI.ArcGIS.ADF.Web.Display.Graphics; 


将 MapResource 类 的 声明 修改 为 如 下 代码 ， 增 加 对 地 图 资源 接口 实现 的 声明 : 

public class MapResource : IMapResource 

然后 利用 开发 环境 的 代码 自动 功能 ， 创 建 IMapResource 与 IGISResource 接口 要 实现 的 属性 与 
方法 的 框架 。 

首先 来 完成 IMapResource 接口 的 实现 。 在 其 代码 段 中 加 入 如 下 代码 : 

private IMapInformation mapInformation = null; 


private ESRI.ArcGIS.ADF.Web.DisplaySettings displaySettings = null; 


public IMapInformation MapInformation { 
get ( 
return mapInformation; 


) 
set ( 

mapInformation - value; 
) 


) 


public ESRI.ArcGIS.ADF.Web.DisplaySettings DisplaySettings ( 
get ( 
return displaySettings; 


) 
set ( 
displaySettings - value; 
) 
} 
IMapResource 接口 的 实现 很 简单 ， 先 根据 要 实现 的 属性 ， 定 义 两 相应 的 字段 ， 然 后 加 入 get 
与 set 方法 即 可 。 


在 IGISResource 接口 实现 代码 段 中 ， 先 实现 其 要 求 的 属性 。 代 码 如 下 : 


bool initialized = false; 
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public bool Initialized { 
get { 
return initialized; 


} 
) 


然后 在 MapResource 类 自身 代码 段 中 加 入 如 下 构造 函数 与 属性 : 


public MapResource() { 
} 


public MapResource (string name, GISDataSource dataSource) { 
this.name = name; 
this.dataSource = dataSource; 


private string key { 
get { 
string tmp = this.GetType().ToString() + ":" + name; 
return (tmp); 


) 

下 面 要 实现 的 是 IGISResoure 接口 的 方法 。 其 中 一 类 是 功能 的 创建 与 判断 ， 其 中 方法 
SupportsFunctionality 用 于 判断 当前 资源 是 否 支持 某 类 型 的 功能 。 对 于 本 实例 ， 支 持 的 是 绘图 功能 、 
地 图 切片 功能 与 Toc 功能 ， 因 此 实现 代码 如 下 : 


public bool SupportsFunctionality(System.Type functionalityType) ( 
if (functionalityType == typeof (IMapFunctionality)) 
return true; 
else if (functionalityType == typeof (ITileFunctionality)) 
return true; 
else if (functionalityType == typeof (IMapTocFunctionality)) 
return true; 
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else return false; 


) 

CreateFunctionality 方法 用 于 创建 指定 类 型 的 功能 对 象 。 即 针对 支持 的 功能 ， 分 别 用 new 关键 
字 构 造 MapFunctionality、TileFunctionality 与 MapTocFunctionality 实例 ， 这 些 也 都 是 在 本 节 后 面 内 
容 要 实现 的 类 。 代 码 如 下 : 


public IGISFunctionality CreateFunctionality (System.Type functionalityType, 
string functionalityName) 
t 
IGISFunctionality func = null; 
if (functionalityType == typeof(IMapFunctionality)) ( 
func = new MapFunctionality(functionalityName, this); 
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else if (functionalityType == typeof(ITileFunctionality)) ( 
TileCacheInfo tileCacheInfo 


mapInformation.TileCacheInfo as TileCacheInfo; 
func = new TileFunctionality(functionalityName, this, tileCacheInfo); 
) 
else if (functionalityType == typeof (IMapTocFunctionality)) ( 
TileCacheInfo tileCacheInfo = 
mapInformation.TileCacheInfo as TileCacheInfo; 
func = new MapTocFunctionality (functionalityName, this, tileCacheInfo); 


) 
else ( 

throw new ArgumentException ("functionalityType"); 
) 


return func; 


) 


IGISResource 接口 方法 的 另 一 大 类 是 有 关 状 态 维护 的 。 其 中 LoadState 方法 用 于 从 数据 源 对 象 
中 获取 状态 信息 ，SaveState 方法 用 于 将 状态 信息 保存 到 数据 源 对 象 中 ， 而 ClearState 方法 用 于 清除 
状态 。 它 们 的 实现 代码 如 下 : 


public void LoadState() ( 


if (dataSource -- null) 
return; 

if (dataSource.State == null) 
return; 


object o = dataSource.State[key]; 

if (o !2 null) ( 
MapResource mr - o as MapResource; 
mapInformation = mr.mapInformation; 
layerVisibility = mr.layerVisibility; 


public void SaveState() ( 


if (dataSource -- null) 
return; 

if (dataSource.State == null) 
return; 


dataSource.State[key] = this; 


public void ClearState() ( 
mapInformation = null; 
layerVisibility = null; 
| 


IGISResource 接口 中 最 重要 的 方法 是 初始 化 方法 mnitialize， 我 们 需要 在 方法 中 ， 从 数据 源 指定 
的 位 置 处 读 入 数据 。 实 现代 码 如 下 : 


public void Initialize() 
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if (mapInformation == null) ( 


mapInformation = new MapInformation (dataSource.DataSourceDefinition, 


resourceDefinition); 


if (layerVisibility == null) ( 
TileCacheInfo tileCacheInfo = 
(TileCacheInfo)mapInformation.TileCacheInfo; 
layerVisibility = new Dictionary«string, bool»(); 
if (tileCacheInfo.Layers !- null) ( 


foreach (KeyValuePair«string, string» kvp in tileCacheInfo.Layers) 


layerVisibility.Add(kvp.Key, true); 
) 
) 
initialized = true; 


} 


在 上 述 方法 中 ， 先 利用 MapInformation 类 (将 在 下 一 小 节 中 实现 ) 的 构造 函数 ， 从 数据 源 


6.33 ”实现 地 图 信息 接口 


指定 的 位 置 处 读 入 地 图 切片 信息 ， 保 存在 TileCacheInfo 属性 中 。 然 后 通过 该 属性 ， 初 始 化 
layerVisibility 字段 。 


下 面 需 要 实现 的 是 从 地 图 信息 接口 的 类 中 读 取 地 图 切片 信息 。 该 切片 信息 存储 在 一 配置 文件 


在 工程 增加 一 个 类 ， 命 名 为 MapInformation。 

在 该 类 声明 代码 之 前 加 入 如 下 命名 空间 的 引用 : 
using ESRI.ArcGIS.ADF.Web.Display.Graphics; 
using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.SpatialReference; 


using ESRI.ArcGIS.ADF.Web.DataSources; 
using System.Xml; 


将 MapInformation 类 的 声明 修改 为 如 下 代码 ， 增 加 对 地 图 信息 接口 实现 的 声明 : 
public class MapInformation: I MapInformation 


然后 利用 开发 环境 的 代码 自动 功能 ， 创 建 MapInformation 接口 要 实现 的 属性 的 框架 。 


简单 ， 纯 粹 是 进行 体力 劳动 ， 如 下 所 示 : 


private string dataSourceConfig = string.Empty; 

private string resourceConfig - string.Empty; 

private SpatialReference defaultSpatialReference = null; 
private TileCacheInfo tileCacheInfo = null; 

private Envelope defaultExtent, fullExtent; 


中 。 读 者 可 从 本 书 网 上 所 附 源 代码 文件 的 CustomDataSource CustomDataSourceTestiData. 目录 下 找 
到 名 为 VirtualEarth original.xml 的 文件 ， 即 是 该 配置 文件 。 


代码 很 


第 6 章 自 定义 数据 源 4 加 


然后 加 入 MapInformation 类 如 下 所 示 的 构造 函数 : 


在 上 述 构造 函数 中 ， 调 用 parseConfig 方法 ， 从 配置 文件 中 读 取 地 图 切片 信息 。 该 方法 的 代码 
如 下 : 


~ 
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doc.Load (dataSourceConfig); 

XmlNode root = doc.DocumentElement; 

// HX TileCacheInfo 节点 

XmlNodeList tileCacheInfoNodes - root.SelectNodes ("TileCacheInfo"); 


if (tileCacheInfoNodes -- null || tileCacheInfoNodes.Count « 1) 
throw new Exception ("在 资源 中 找 不 到 配置 信息 :" + resourceConfig); 


XmlNode tileCacheNode = null; 
Dictionary<int, string> tileUrls = new Dictionary<int, string>(); 
Dictionary<string, string> layers = new Dictionary<string, string>(); 


for (int t = 0; t < tileCacheInfoNodes.Count; ++t) { 
E (tileCacheInfoNodes[t].Attributes["Name"].InnerText == 


resourceConfig) ( 


tileCacheNode - tileCacheInfoNodes[t]; 
break; 


) 
if (tileCacheNode -- null) 

tileCacheNode - tileCacheInfoNodes[0]; 
#endregion 


$region 缓存 地 图 切片 信息 
// 获取 SpatialReference 节点 内 容 , 即 坐标 系统 定义 字符 串 
string srtext = tileCacheNode.Attributes["SpatialReference"].InnerText; 
int srid; 
// 设置 默认 的 空间 参考 对 象 defaultSpatialReference 
if (Int32.TryParse(srtext, out srid)) { 
defaultSpatialReference = new SpatialReference (srid); 
) 
else ( 
defaultSpatialReference = new SpatialReference (srtext); 


int dpi = Convert.ToInt32 (tileCacheNode.Attributes["DPI"].InnerText); 
int height = 

Convert.ToInt32 (tileCacheNode.Attributes ["Height"].InnerText); 
int width = Convert.ToInt32 (tileCacheNode.Attributes["Width"].InnerText); 
// 原点 坐标 
string[] originCoords = tileCacheNode.Attributes 

["TileOrigin"].InnerText.Split(new char[] ( ',' }); 

double xmin = Convert.ToDouble (originCoords[0]); 
double ymin = Convert.ToDouble (originCoords[1]); 
Point origin = new Point(xmin, ymin); 


// 全 图 范围 

XmlNode extentNode = tileCacheNode.SelectSingleNode ("FullExtent"); 
xmin = Convert.ToDouble (extentNode.Attributes["XMin"].InnerText); 
ymin = Convert.ToDouble (extentNode.Attributes["YMin"].InnerText); 
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double xmax = Convert.ToDouble (extentNode.Attributes["XMax"].InnerText); 
double ymax = Convert.ToDouble (extentNode.Attributes["YMax"].InnerText); 
fullExtent = new Envelope(xmin, ymin, xmax, ymax); 


// 默认 显示 范围 
extentNode = tileCacheNode.SelectSingleNode ("DefaultExtent"); 
xmin = Convert.ToDouble (extentNode.Attributes["XMin"].InnerText); 


ymin = Convert.ToDouble (extentNode.Attributes["YMin"].InnerText); 
xmax — Convert.ToDouble (extentNode.Attributes["XMax"].InnerText); 
ymax = Convert.ToDouble (extentNode.Attributes["YMax"].InnerText); 
defaultExtent = new Envelope(xmin, ymin, xmax, ymax); 

#endregion 

#region 图 层 


// 获取 图 层 id 和 名 称 
XmlNode layersNode = tileCacheNode.SelectSingleNode ("Layers"); 
if (layersNode !- null) 


{ 
XmlNodeList layerNodes = layersNode.SelectNodes ("Layer"); 
if (layerNodes !- null) ( 
for (int 1 = 0; 1 < layerNodes.Count; ++1) ( 
string layerId = layerNodes[1l].Attributes["LayerID"].InnerText; 
string layerName = layerNodes[l].Attributes["Name"].InnerText; 
layers.Add(layerId, layerName); 
} 
} 
} 
#endregion 


#region LOD(Level Of Details， 多 细节 等 级 ， 也 就 是 多 比例 尺 ) 信息 

// 获取 各 个 比例 尺 的 信息 

System.Collections.Generic.List<LodInfo> lodInfos = new List<LodInfo>(); 
System.Collections.Generic.Dictionary<int, int> levels = new 


Dictionary<int, int>(); 


XmlNode lodInfoNode = tileCacheNode.SelectSingleNode ("LodInfos"); 
XmlNodeList lodInfoNodes - lodInfoNode.SelectNodes ("LodInfo"); 
for (int 1 = 0; 1 < lodInfoNodes.Count; 441) ( 

// 该 细节 等 级 ID 


int levelid - 


Convert.ToInt32(lodInfoNodes[l].Attributes["LevelID"].InnerText); 


levels.Add(l, levelid); 
// 该 细节 等 级 地 图 切片 行 方向 的 数量 


int rows = 


Convert .ToInt32 (lodInfoNodes [1] .Attributes ["Rows"] .InnerText); 


// 该 细节 等 级 地 图 切片 列 方向 的 数量 


int columns = 


Convert .ToInt32 (lodInfoNodes [1] .Attributes ["Columns"] .InnerText); 


// 地 图 切片 URL 地 址 ， 配 置 文件 中 没有 给 出 ， 可 以 通过 程序 计算 出 该 地 址 
string tileUrl = lodInfoNodes[l].Attributes["TileUrl"].InnerText; 
// 地 图 切片 空间 宽度 
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double tilewidth 


Convert.ToDouble (lodInfoNodes [1] .Attributes["TileExtentWidth"] .InnerText); 


// 地 图 切片 空间 宽度 
double tileheight 


Convert.ToDouble (lodInfoNodes[1].Attributes["TileExtentHeight"].InnerText); 


// 该 细节 等 级 对 应 的 比例 尺 


double scale 
Convert.ToDouble (lodInfoNodes[l1].Attributes["Scale"].InnerText); 
double resolution 


Convert.ToDouble (lodInfoNodes[l].Attributes["Resolution"].InnerText); 


LodInfo lodInfo = new LodInfo (levelid, resolution, scale, columns, rows, 


tilewidth, tileheight); 
lodInfos.Add(lodInfo); 
tileUrls.Add(levelid, tileUrl); 
) 


#endregion 


// 设置 TileCacheInfo 

tileCacheInfo = new TileCacheInfo(width, height, 
dpi, origin, lodInfos.ToArray()); 

tileCacheInfo.TileUrls = tileUrls; 

tileCacheInfo.Layers - layers; 

tileCacheInfo.Levels - levels; 


// 获取 Virtual Earth 切片 图 片 路 径 处 理 类 的 类 库 名 称 与 类 名 


XmlNode urlGenNode = tileCacheNode.SelectSingleNode ("TileUrlGenerator"); 


if (urlGenNode !- null) 
{ 
tileCacheInfo.TileUrlGeneratorAssembly = 
urlGenNode .Attributes ["Assembly"].InnerText; 
tileCacheInfo.TileUrlGeneratorClass = 
urlGenNode .Attributes ["Class"].InnerText; 


) 
代码 中 已 经 给 出 了 每 段 代 码 的 含义 ， 这 里 不 再 獒 述 。 


6.34 地 图 切片 信息 类 


为 了 调用 方便 ， 新 增加 了 一 个 类 ， 继 承 Web ADF 中 的 TileCacheInfo。 该 类 的 属性 与 方法 如 图 


6.12 所 示 。 
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TileCachelnfo 
ESRLArcGIS.ADF Web.DataSources 


class TileCachelnfo 


TileCachelnfo (.. [overloaded]...) 


Dpi: System.Int32 

Height: System.Int32 

Lodinfos: Lodinfo[] 

Origin: 
ESRLArcGIS.ADF.Web.Geometry.Point 

ServiceUrt: System.String 

Width: System.Int32 


Compare (TileCachelnfo other): 
System.Boolean 


图 6.12 ESRLArcGIS.ADF.Web.DataSources.TileCacheInfo 类 的 属性 与 方法 
在 工程 增加 一 个 类 ， 命 名 为 TileCacheInfo. 
在 该 类 声明 代码 之 前 加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web.DataSources; 
using ESRI.ArcGIS.ADF.Web.Geometry; 


将 TileCacheInfo 类 的 声明 修改 为 如 下 代码 : 
class TileCacheInfo : ESRI.ArcGIS.ADF.Web.DataSources.TileCacheInfo 
TileCacheInfo 类 的 代码 很 简单 ， 主 要 目的 就 是 增加 两 个 不 同 的 构造 函数 而 已 。 代 码 如 下 : 


public TileCacheInfo(int width, int height, int dpi, 
Point origin, LodInfo[] lodInfos) 
: base(width, height, dpi, origin, lodInfos) ( 


public TileCacheInfo(ESRI.ArcGIS.ADF.Web.DataSources.TileCacheInfo tci) 
: base(tci.Width, tci.Height, tci.Dpi, tci.Origin, tci.LodInfos) ( 


internal Dictionary<int, int» Levels = new Dictionary«int, int»(); 
internal Dictionary«int, string» TileUrls = new Dictionary«int, string»(); 
internal Dictionarycstring, string» Layers = new Dictionarycstring, string»(); 
internal string TileUrlGeneratorAssembly; 

internal string TileUrlGeneratorClass; 


6.3.5 ”实现 绘图 功能 


在 工程 增加 一 个 类 ， 命 名 为 MapFunctionality。 
在 该 类 声明 代码 之 前 加 入 如 下 命名 空间 的 引用 : 
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using System.Collections; 

using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.SpatialReference; 
using ESRI.ArcGIS.ADF.Web.DataSources; 
using ESRI.ArcGIS.ADF.Web.Display.Graphics; 
using ESRI.ArcGIS.ADF.Web.Display.Drawing; 
using ESRI.ArcGIS.ADF.Web; 


将 MapFunctionality 类 的 声明 修改 为 如 下 代码 ， 增 加 对 绘图 功能 接口 实现 的 声明 : 
public class MapFunctionality: IMapFunctionality 


然后 利用 开发 环境 的 代码 自动 功能 , 创建 IMapFunctionality 与 IGISFunctionality 接口 要 实现 的 
属性 与 方法 的 框架 。 
首先 来 完成 IMapFunctionality 接口 的 实现 。 在 其 代码 段 中 加 入 如 下 代码 : 


private ESRI.ArcGIS.ADF.Web.DisplaySettings displaySettings = null; 
private System.Web.UI.WebControls.WebControl webControl - null; 
private bool maintainsState - false; 

private SpatialReference spatialReference - null; 

private Dictionarycstring, bool» layerVisibility = null; 

private Envelope extent; 


public bool MaintainsState ( 
get ( 
return maintainsState; 
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} 
set { 
maintainsState = value; 


public System.Web.UI.WebControls.WebControl WebControl ( 
get ( 
return webControl; 


) 
set { 

webControl - value; 
) 


public ESRI.ArcGIS.ADF.Web.DataSources.Units Units { 
get ( 
throw new NotiImplementedException(); 


public ESRI.ArcGIS.ADF.Web.DisplaySettings DisplaySettings { 
get { 
if (maintainsState) ( 
if (displaySettings == null) { 
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public double Rotation { 
get { 
return double.NaN; 


public Dictionary<string, bool> LayerVisibility { 
get { 
if (maintainsState) 
return MapResource.layerVisibility; 
else 
return layerVisibility; 


public bool GetLayerVisibility(string layerID) ( 
return LayerVisibility[layerID]; 
H 


public void SetLayerVisibility(string layerID, bool visible) ( 
LayerVisibility[layerID] = visible; 
) 


由 于 这 里 使 用 了 地 图 切片 ， 因 此 绘图 功能 并 不 重要 了 , 不 由 该 类 来 实现 生成 地 图 图 片 ， 而 是 由 


地 图 切片 功能 来 实现 。 该 类 的 主要 任务 是 保存 一 些 地 图 信息 ， 例 如 空间 参考 、 显 示 设 置 等 。 因 此 对 
于 IMapFunctionality 接口 要 求实 现 的 其 他 方法 ， 保 留 集成 开发 环境 自动 生成 的 代码 即 可 。 


在 MapFunctionality 类 自身 的 代码 段 中 ， 加 入 如 下 代码 : 


public MapFunctionality(string name, MapResource resource) { 
this.name = name; 
this.resource = resource; 


public MapResource MapResource { 
get ( 
return resource as MapResource; 


private string key ( 
get { 
string szResource - resource.GetType ().ToString() * ":" * resource.Name; 
string szThis = this.GetType().ToString() + ":" + name; 
return (szResource + "," + szThis); 


} 
IGISFunctionality 接口 的 实现 代码 如 下 : 


private string name = string.Empty; 
private IGISResource resource = null; 
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MapResource mapRes = resource as MapResource; 
foreach (KeyValuePaircstring, bool» kvp in mapRes.layerVisibility) 
layerVisibility.Add(kvp.Key, kvp.Value); 


} 


public void Dispose() { 
initialized = false; 


} 


public bool Supports (string operation) { 
return false; 


} 
上 述 代码 中 ， 也 没有 重要 的 方法 。 


6.3.6 ”地 图 切片 功能 的 实现 


Web ADF 中 地 图 切片 功能 接口 的 属性 与 方法 如 图 6.13 所 示 ， 比 较 简 单 ， 就 只 包含 一 个 生成 一 


张 地 图 图 片 的 Draw 方法 与 三 个 只 读 属性 。 


ITileFunctionality 


W— mageFormat: 
ESRI.ArcGIS.ADF.Web.WeblmageForm 
at 


W— ServiceUrl: System.String 
W— UriGeneratorJSFunction: System.String 


-(4— Draw (System.String 
mapFunctionalityName, System.Int64 
column, System.Int64 row, System.Int32 
level): 
ESRI.ArcGIS.ADF.Web.Maplmage 


图 6.13 地 图 切片 功能 要 求实 现 的 属性 与 方法 
在 工程 增加 一 个 类 ， 命 名 为 TileFunctionality。 
在 该 类 声明 代码 之 前 加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web.DataSources; 
using ESRI.ArcGIS.ADF.Web; 
using System.Reflection; 


ff TileFunctionality 类 的 声明 修改 为 如 下 代码 ， 增 加 对 地 图 切片 功能 接口 实现 的 声明 : 
public class TileFunctionality: ITileFunctionality 


然后 利用 开发 环境 的 代码 自动 功能 ， 创 建 TTileFunctionality 与 IGISFunctionality 接口 要 实现 的 


属性 与 方法 的 框架 。 


首先 来 完成 IGISFunctionality 接口 的 实现 。 在 其 代码 段 中 加 入 如 下 代码 : 
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public bool Supports (string operation) ( 
return true; 
} 
与 绘图 功能 正好 相反 ,地 图 切片 功能 的 实现 主要 是 在 ITileFunctionality 中 完成 而 绘图 功能 
实现 主要 在 IGISFunctionality 中 完成 ， 因 此 上 述 IGISFunctionality 接口 的 实现 代码 非常 简单 。 
在 TileFunctionality 类 自身 代码 段 中 加 入 如 下 代码 : 


TileCacheInfo tileCacheInfo = null; 


public TileFunctionality(string name, MapResource resource, 
TileCacheInfo tileCacheInfo) 
t 

this.name = name; 

this.resource = resource; 

this.tileCacheInfo - tileCacheInfo; 


private MapFunctionality GetMapFunctionality(string name) 
MapFunctionality mapFunctionality = resource.Functionalities.Find (name) 


as MapFunctionality; 
return mapFunctionality; 
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private object getInstanceOfType(string assemblyName, string type) 


object o = null; 

try 

t 
Assembly assembly = Assembly.Load(assemblyName); 
o = assembly.CreateInstance (type); 


) 
catch (Exception e) 
t 
string mess = e.Message; 
) 
return o; 


} 

上 述 代码 中 getInstanceOfType 方法 的 目的 是 根据 程序 集 名 称 与 类 名 ， 创 建 类 的 实例 。 这 是 由 
于 是 在 配置 文件 中 ， 指 定 生成 Virtual Earth 地 图 切片 URL 地 址 的 类 ， 在 开发 程序 时 不 知道 该 类 的 
名 称 ， 因 此 需要 该 方法 来 在 程序 运行 期 间 ， 根 据 配 置 参数 动态 创建 类 的 实例 。 

下 面 要 实现 的 是 ITileFunctionality 接口 。 其 代码 如 下 : 


private string serviceUrl; 


public string ServiceUrl 
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return serviceUrl; 


public string UrlGeneratorJSFunction 
t 

get 

{ 


return null; 


) 
} 
public WebImageFormat ImageFormat 
t 

get 

t 


return WebImageFormat.JPG; 


public ESRI.ArcGIS.ADF.Web.MapImage Draw(string mapFunctionalityName, 
long column, long row, int level) 
{ 

int realLevel = tileCacheInfo.Levels[level]; 

string baseUrl - tileCacheInfo.TileUrls[realLevel]; 

if (string.IsNullOrEmpty (tileCacheInfo.TileUrlGeneratorAssembly) 
11 string.IsNullOrEmpty (tileCacheInfo.TileUrlGeneratorClass)) 
return null; 

ITileUrlGenerator urlGen - getInstanceOfType 
(tileCacheInfo.TileUrlGeneratorAssembly, 
tileCacheInfo.TileUrlGeneratorClass) as ITileUrlGenerator; 

if (urlGen -- null) 
return null; 


MapFunctionality mapFunc = GetMapFunctionality (mapFunctionalityName); 
if (mapFunc == null) 
throw new ArgumentException ("mapFunctionalityName"); 


serviceUrl = urlGen.GetTileUrl(column, row, 
realLevel, baseUrl, mapFunc.LayerVisibility); 


return new ESRI.ArcGIS.ADF.Web.MapImage (serviceUrl, null); 
) 


ITileFunctionality 接口 中 最 重要 的 就 是 Draw 方法 。 在 该 方法 中 , 我 们 先 利用 getInstanceOfType 
方法 , 创建 配置 文件 中 指定 的 类 的 事例 , 然后 利用 该 类 的 GetTileUrl 方法 , 根据 地 图 切片 所 在 的 行 、 
列 、 细 节 等 级 ， 计 算 地 图 切片 的 URL 地 址 ， 最 后 调用 Web ADF 中 Web 类 的 MapImage 静态 方法 ， 
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从 该 地 址 获取 一 地 图 图 片 。 

当然 在 地 图 切片 配置 文件 中 不 能 随意 指定 用 于 获取 URL 地 址 的 类 ， 该 类 必须 实现 了 
ITileUrlGenerator 接口 。 

在 当前 工程 中 新 增加 一 接口 ， 命 名 为 ITileUrlGenerator。 在 其 中 加 入 如 下 代码 : 


public interface ITileUrlGenerator 
{ 
string GetTileUrl(long column, long row, int level, 
string defaultUrl, Dictionary«string, bool» layerVisibility); 
) 


在 该 接口 定义 了 一 个 名 为 GetTileUrl 方法 , 该 方法 就 是 利用 参数 指定 的 地 图 切片 所 在 的 行 、 列 、 
细节 等 级 ， 计 算 地 图 切片 的 URL 地 址 。 

我 们 在 地 图 切片 配置 文件 中 指定 了 用 VirtualEarthTileUrlGenerator 类 来 计算 URL. 

在 工程 中 新 增加 名 为 VirtualEarthTileUrlGenerator 的 类 , 该 类 实现 ITileUrlGenerator 
接口 。 

VirtualEarthTileUrlGenerator 的 实现 代码 如 下 : 


public string GetTileUrl(long column, long row, 
int level, string defaultUrl, Dictionary«string, bool» layerVisibility) 
d 
return GetUrl(Convert.ToInt32 (column), Convert .ToInt32 (row), 
level, layerVisibility); 
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/// «summary» 
/// 计算 地 图 切片 的 URL 地 址 
/// </summary> 
/// «param name="column"> 地 图 切片 所 在 列 </param> 
/// <param name="row"> 地 图 切片 所 在 行 </param> 
/// «param name="level"> 地 图 切片 所 在 细节 等 级 </param> 
/// «param name="layerVisibility"> 可 见 图 层 </param> 
/// <returns></returns> 
private string GetUrl(int column, int row, int level, 
Dictionarycstring, bool» layerVisibility) 
t 
string mapType - null; 
string mapExtension = null; 


// 如 果 同 时 包括 Road 图 层 和 Aerial HE 
if (layerVisibility["r"] && layerVisibility["a"]) 


t 
mapType = "h"; 
mapExtension = ".jpeg"; 
) 
// 只 包括 Road 图 层 


else if (layerVisibility["r"]) 


第 6 章 自 定义 数据 源 4 © 


对 于 微软 Virtual Earth 地 图 切片 的 URL 地 址 计算 方法 是 固定 的 ， 具 体 算法 见 程序 的 注释 。 
6.3.7 ”实现 Toc 功能 
在 工程 增加 一 个 类 ， 命 名 为 MapTocFunctionality。 


在 该 类 声明 代码 之 前 加 入 如 下 命名 空间 的 引用 : 
(using ESRI.ArcGIS.ADF.Web.DataSources; — 
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© using ESRI.ArcGIS.ADE-Meb; 00000 
将 MapTocFunctionality 类 的 声明 修改 为 如 下 代码 ， 增 加 对 绘图 功能 接口 实现 的 声明 : 
| public class MapTocFunctionality: IMapTocFunctionality 


然后 利用 开发 环境 的 代码 自动 功能 ， 创 建 IMapTocFunctionality 与 IGISFunctionality 接口 要 实 
现 的 属性 与 方法 的 框架 。 
首先 来 完成 IGISFunctionality 接口 的 实现 。 在 其 代码 段 中 加 入 如 下 代码 : 
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IGISFunctionality 接口 实现 的 代码 很 简单 ， 只 是 简单 地 设置 几 个 值 。 
在 MapTocFunctionality 类 自 身 代码 段 中 ， 加 入 如 下 代码 : 


下 面 要 实现 的 是 Toc 功能 接口 。 在 IMapTocFunctionality 代码 段 中 加 入 如 下 代码 : 
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public void SetLayerVisibility(string mapFunctionalityName, 
object layerID, bool visible) { 
MapFunctionality mapFunc = GetMapFunctionality (mapFunctionalityName); 
if (mapFunc == null) 
throw new ArgumentException ("mapFunctionalityName"); 
mapFunc.SetLayerVisibility(layerID.ToString(), visible); 


public ESRI.ArcGIS.ADF.Web.TocDataFrame[] GetMapContents( 
string mapFunctionalityName, WebImageFormat format, 
bool useMimeData, bool showAllDataFrames) { 
TocDataFrame[] tocDataFrames - new TocDataFrame[1]; 
tocDataFrames[0] = new TocDataFrame (resource.Name); 
if ( tileCacheInfo.Layers !- null) 
{ 
foreach (KeyValuePair«string, string» kvp in tileCacheInfo.Layers) 
{ 
TocLayer layer = new TocLayer(); 
layer.LayerName - kvp.Value; 
layer.ID = kvp.Key; 
layer.Name - kvp.Key; 
layer.Visible - true; 
tocDataFrames[0].Add (layer); 


) 


return tocDataFrames; 


) 

代码 也 相对 简单 ， 在 SetLayerVisibility 方法 中 ， 通 过 调用 绘图 功能 的 SetLayerVisibility 方法 设 
置 图 层 的 可 见 性 。 在 GetMapContents 方法 中 ， 根 据 切片 信息 创建 TocLayer。 

至 此 就 完成 了 从 微软 Virtual Earth 网 站 获取 地 图 切片 作为 数据 源 的 开发 。 


6.3.8 注册 自 定义 数据 源 


本 实例 实现 的 自 定义 数据 源 的 配置 文件 内 容 如 下 : 


«?xml version-"1.0" encoding-"utf-8" ?> 
XDataSources» 
«DataSource name-"TiledMap Data"» 
«Implementation assembly -"TiledMapDataSource" 
class-"TiledMapDataSource.GISDataSource"»«/Implementation» 
XIdentityEditorForm assembly -"ESRI.ArcGIS.ADF.Web.UI.WebControls" 
class-"ESRI.ArcGIS.ADF.Web.UI.WebControls.Design.UnusedPropertyEditor 
"»«/IdentityEditorForm» 
XDefinitionEditorForm assembly -"" class-""»«/DefinitionEditorForm» 
«Resource type-"Map"» 
XDefinitionEditorForm assembly ="" class-""»«/DefinitionEditorForm» 
«Implementation assembly -"TiledMapDataSource" 
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class-"TiledMapDataSource.MapResource"»«/Implementation? 
«/Resource» 
«/DataSource» 
«/DataSources» 
将 其 保存 为 ESRIArcGIS.ADF.Web .DataSources.TiledMapData.config, 并 拷贝 到 ArcGIS 安装 目 
录 的 DotNet XRH. 
该 文件 读者 也 可 直接 从 本 书 网 上 所 附 源 代 码 文件 的 CustomDataSource\TiledMapDataSource 目 
录 中 找到 。 


6.3.9 测试 自 定义 遥感 影像 数据 源 功能 


切换 到 解决 方案 的 CustomDataSourceTest 工程 中 ， 首 先 通过 工程 右键 菜单 的 Add Reference 命 
令 ， 将 TiledMapDataSource 工程 引用 进来 。 

在 工程 中 新 增加 一 个 ASP.NET 页 面 ， 命 名 为 TiledMapTest。 

在 TiledMapTest.aspx 页 面 中 增加 一 地 图 资源 管理 器 控件 、 一 地 图 控件 与 一 Toc 控件 。 打 开 地 
图 资源 管理 器 控件 的 MapResourcesItem 属性 设置 对 话 框 ， 在 其 中 先 添加 一 地 图 资源 ， 然 后 通过 
Definition 属性 ， 打 开 Map Resource Definition Editor 对 话 框 。 这 时 在 数据 源 类 型 的 下 拉 框 中 有 了 我 
们 在 6.3.8 节 中 注册 的 数据 源 类 型 TiledMap Data。 选 择 该 类 型 。 然 后 将 DataSource 设置 为 我 们 在 
6.3.3 节 配 置 文件 保存 的 路 径 。 读 者 可 以 直接 从 本 书 配套 的 源 代码 文件 中 拷贝 该 配置 文件 ， 文 件 在 
CustomDataSource\CustomDataSourceTest\Data 目录 中 ， 文 件 名 为 VirtualEarth_original. xml 。 

然后 再 加 入 NorthAmericaMap 地 图 资源 ， 并 加 入 ArcGIS 身份 信息 。 

编译 并 运行 程序 ， 便 可 得 到 如 图 6.14 所 示 的 遥感 影像 与 撩 量 要 素 图 县 加 的 效果 。 
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图 6.14 自 定义 遥感 影像 数据 源 


当然 互联 网 上 提供 类 似 遥 感 数据 服 务 的 网 站 很 多 ， 包 括 Google Earth， 以 及 第 1 章 提 到 的 几 个 
网 站 。 有 兴趣 或 需要 的 读者 , 也 可 以 通过 自 定义 数据 源 的 方式 将 它们 提供 的 数据 集成 到 自己 的 应 用 
程序 中 。 


在 前 面 的 章节 中 虽然 许多 地 方 都 使 用 了 图 形 及 其 操作 ， 但 是 并 没有 对 它们 进行 过 多 的 说 


。 我 们 将 在 本 章 中 详细 介绍 图 形 操 作 的 相关 命名 空间 、 类 与 接口 。 
通过 本 章 你 将 了 解 到 : 


7.1 图 形 及 相关 类 概述 

7.2 图形 操作 的 不 同 层次 
7.3 在 Web 端 操 作 图 形 

7.4 ”在 GIS 服务 器 端 操作 图 形 
7.5 图 形 对 象 的 转换 
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7.1 图 形 及 相关 类 概述 


正如 前 面 多 次 提 到 的 ，Web ADF 是 一 多 数据 源 框 架 ， 因 此 可 以 在 同一 应 用 程序 中 使 用 多 个 不 
同类 型 的 数据 。 每 个 数据 源 还 可 能 独立 使 用 自身 特有 的 API 来 操作 数据 。 由 于 最 终 要 由 Web ADF 
负责 将 多 个 数据 源 的 结果 显示 在 Web 端 或 客户 端 ， 因 此 Web ADF 自身 必须 有 一 定 的 逻辑 ， 在 一 
个 公共 的 环境 ， 集 成 这 些 结 果 。 为 实现 该 目的 ，Web ADF 包含 了 一 组 类 来 集成 ， 例 如 空间 参考 、 
几何 类 型 、 属 性 查询 以 及 空间 查询 等 。 最 重要 的 是 ，Web ADF 中 有 一 组 类 来 支持 Web 端 图 形 数据 
集合 与 图 层 的 类 。 

Web ADF 中 图 形 与 相关 类 包含 在 ESRIArcGIS.ADF.Web.dll 程序 集中 。 该 程序 集 包含 根据 内 
容 的 类 别 又 分 成 多 个 命名 空间 。 表 7-1 列 出 了 该 程序 集中 的 命名 空间 及 其 主要 作用 。 


表 7-1 ESRI.ArcGIS.ADF.Web.dll 程序 集中 的 命名 空间 及 其 主要 作用 


命名 空间 主要 作用 

ESRLArcGIS.ADF.Web Web 端 地 图 图 片 的 创建 与 管理 、 空 间 与 属性 查询 、Toc 图 层 内 容 
ESRI.ArcGIS.ADF.Web.Display.Graphics Web ADF 的 图 形 数据 集 、 图 层 以 及 要 素 
ESRI.ArcGIS.ADF.Web.Display.Renderer ”应 用 于 Web ADF 图 形 的 着 色 器 
ESRI.ArcGIS.ADF.Web.Display.Swatch 用 于 为 Toc 生成 样本 

ESRI.ArcGIS.ADF.Web.Display.Symbol 用 于 Web ADF 图 形 的 符号 


ESRLArcGIS.ADF.Web.Geocode 用 于 地 理 编 码 资源 与 功能 的 抽象 类 型 
ESRI.ArcGIS.ADF.Web.Geometry 在 Web 端 应 用 的 几何 类 型 。 常 用 于 为 图 形 图 层 内 容 定义 要 素 、 
地 图 控件 的 范围 等 


ESRLArcGIS.ADF.Web.SpatialReference __ 控件 、 资 源 与 功能 的 坐标 系统 
72 图 形 操作 的 不 同 层次 


我 们 在 4.4.3 与 4.5.3 节 中 使 用 两 种 不 同 的 方式 了 高 亮 显示 通过 查询 得 到 的 图 形 , 为 什么 会 有 两 
种 方式 ， 这 两 种 方式 有 什么 区 别 呢 ? 

这 是 由 于 基于 Web ADF 开发 的 应 用 系统 包含 三 层 结构 , 分 别 是 客户 端 “Web 端 以 及 GIS 服务 
器 端 ， 因 此 在 Web ADF 地 图 中 绘制 图 形 可 以 在 三 个 层次 的 任何 一 个 层次 来 实现 。 每 一 层 的 相关 开 
发 环境 都 不 一 样 ， 因 此 需要 应 用 不 同 的 方式 。 由 于 Web ADF 的 目的 是 在 同一 个 应 用 程序 中 使 用 多 
种 数据 源 ， 因 此 它 提供 更 多 的 是 在 Web 端 创建 与 管理 图 形 的 方法 。 
非常 重要 的 是 ， 开 发 人 员 必 须 了 解 通常 需要 在 哪 创建 图 形 ， 以 及 Web ADF 是 如 何 集成 每 个 层 
次 的 图 形 的 。 图 7.1 表明 在 每 个 层次 上 可 在 哪里 创建 图 形 图 层 。 Web ADF 管理 包括 Web ADF 图 形 、 
ArcGIS Server 与 ArcIMS 等 一 组 资源 ， 其 中 Web ADF 图 形 资源 使 用 Web ADF 的 功能 创建 图 形 图 
层 与 生成 地 图 图 片 ， 这 是 4.5.3 节 使 用 的 方式 。 而 ArcGIS Server 与 ArcIMS 资源 使 用 它们 各 自在 
GIS 服务 器 端的 服务 功能 ， 来 创建 图 形 图 层 ， 并 与 地 图 中 其 他 图 层 数 据 合 并 生成 一 张 地 图 图 片 ， 这 
是 4.4.3 节 使 用 的 方式 。 如 果 将 地 图 控件 的 ImageBlendingMode 属性 设置 为 Browser， 这 通常 是 默 
认 值 ， 那么 所 有 的 地 图 图 片 ， 依 据 资 源 的 顺序 在 浏览 器 中 又 加 。 此 外 ， 客户 端 浏览 器 可 使 用 浏览 器 
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的 功能 来 创建 图 形 。 
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图 7.1 每 个 层次 使 用 不 同 的 技术 创建 图 形 


对 于 Web 应 用 程序 来 说 ， 客 户 端 大 多 数 情况 总 是 一 个 浏览 器 。 通 常 ， 浏 览 器 使 用 许多 Web 标 
准 来 与 显示 网 页 ， 并 与 网 页 交互 ， 这 些 标 准 包 括 HTML. CSS 以 及 JavaScript 等 。 在 该 开发 环境 中 ， 
可 用 工具 受 限于 浏览 器 的 支持 。CSS 可 用 于 将 图 像 等 元 素 放置 在 网 页 中 其 他 元 素 之 上 。 浏 览 器 对 
矢量 图 形 的 支持 差别 很 大 , 但 是 可 以 使 用 SVG CScalable Vector Graphics. 可 缩放 矢量 图 形 ) 与 VML 

(Vector Markup Language， 矢 量 可 标记 语言 ) 在 网 页 的 其 他 元 素 之 上 绘制 矢量 图 形 。 

Web ADF 中 有 许多 控件 用 于 客户 端的 图 形 。 例 如 MapTips 控件 使 用 浏览 器 中 的 CSS 在 地 图 上 
放置 一 动态 提示 图 像 。 再 例如 放大 、 图 形 查 询 工 具 ， 和 需要 用 户 交互 时 ， 在 地 图 上 绘制 矩形 、 多 边 形 
等 ， 在 Internet Explorer 浏览 器 中 利用 的 是 VML， 在 其 他 浏览 器 中 利用 的 是 CSS。 我 们 可 以 利用 
Web ADF 来 帮助 在 客户 端 绘制 图 形 ， 但 是 功能 还 是 非常 有 限 。 


7.8 在 Web 端 操作 图 形 


在 4.5.3 节 中 我 们 介绍 了 如 何 通过 在 ElementGraphicsLayer 中 加 入 几何 图 形 对 象 ， 从 而 实现 高 
亮 显示 查询 得 到 的 要 素 。 

ElementGraphicsLayer 几何 图 形 图 层 ) 中 只 包含 几何 图 形 对 象 ， 即 这 些 对 象 只 有 空间 位 置信 
息 ， 没 有 属性 信息 。 但 是 Web ADF 中 还 在 Web 端 提供 了 FeatureGraphicsLayer (要 素 图 形 图 层 ) 
类 ， 该 类 中 的 对 象 是 要 素 ， 即 既 有 空间 位 置信 息 ， 又 有 属性 信息 。 这 两 个 类 都 是 GraphicsLayer 的 
子 类 ， 而 该 类 又 是 NET 中 System.Data DataTable 类 的 子 类 。 

我 们 知道 在 地 图 中 的 数据 源 是 通过 资源 来 访问 的 ， 对 于 Web 端的 图 形 数据 则 是 通过 
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ESRLArcGIS.ADF.Web.DataSources.Graphics.MapResource 类 来 访问 的 。 该 类 的 Graphics 属性 的 类 
型 是 GraphicsDataSet， 它 是 NET 中 System.Data.DataSet 类 的 子 类 。 这 就 是 说 GraphicsDataSet 中 包 
A T GraphicsLayer 类 对 象 的 集合 。 在 FeatureGraphicsLayer 中 又 包含 了 Geometry 类 对 象 的 集合 。 

而 Geometry 是 诸如 Envelope、Point、MultiPoint、Polyline 与 Polygon 等 这 些 几何 类 型 对 象 的 父 类 。 


这 些 类 之 间 的 关系 如 图 7.2 所 示 。 


System.Data.DataSet 
* 


GraphicsDataSet 
1 
1 


System.Data.DataTable 
* 


GraphicsLayer 
* 


FeatureGraphicsLayer | | ElementGraphicsLayei 


T 


* 1 
Geometry GraphicElement 
* 


Envelope | | Point MultiPoint 


Polyline 


Polygon 


图 7.2 图 形 对 象 相关 主要 类 之 间 的 关系 


下 面 我 们 通过 一 个 实例 来 介绍 如 何 创建 图 形 对 象 ， 如 何 添加 到 地 图 中 ， 以 及 如 何 设置 符号 等 。 
在 Visual Studio 2005 中 ， 利 用 File 菜单 的 New Web Site 创建 一 个 新 的 站 点 ， 命 名 为 


CustomRender. 


7.3.1 几何 对 象 的 创建 


几何 对 象 的 创建 很 简单 ， 只 需要 使 用 new 关键 字 新 建 Point、Polyline 与 Polygon 类 实例 即 可 。 
然后 通过 FeatureGraphicsLayer 类 的 Add 方法 加 入 到 图 层 中 即 可 。 
在 工程 中 加 入 ASP.NET 文件 夹 App_Code， 再 在 其 中 加 入 名 为 GenerateGraphicsHelper 
的 类 。 我 们 将 用 在 该 类 中 实现 创建 点 、 线 、 多 边 形 要 素 ， 并 创建 要 素 图 形 图 层 。 其 中 点 、 线 、 面 的 


空间 位 置 是 随机 生成 的 。 
在 该 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web; 
using ESRI.ArcGIS.ADF.Web.Geometry; 


using ESRI.ArcGIS.ADF.Web.Display.Graphics; 


然后 在 类 中 加 入 几 个 辅助 的 字段 : 


private static Random rand = new Random((int)DateTime.Now.Ticks):; 
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private static string[] RandomNames = { "Michel Barama", 
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"Richard Gillespie", 
"Walter Unsworth", 
"Maurice Burton", 
"Roy Saunders" ]; 


创建 点 要 素 图 层 的 方法 代码 如 下 : 


public static FeatureGraphicsLayer CreatePointFeatures (string layerName, 


) 


Envelope env, int count) ( 
if (env == null) 
return null; 


FeatureGraphicsLayer layer - new FeatureGraphicsLayer (FeatureType.Point); 
layer.TableName - layerName; 

layer.Columns.Add("imagePath", typeof(string)); 

layer.Columns.Add ("RandomName", typeof (string)); 


for (int i = 0; < count; itt) ( 
double x = env.XMin + rand.NextDouble() * env.Width; 
double y = env.YMin + rand.NextDouble() * env.Height; 
DataRow row = layer.Add(new Point(x, y)):; 
row["imagePath"] = String.Format ("-/images/(0].gif", rand.Next (3) + 1); 
row["randomName"] = RandomNames[rand.Next (RandomNames.Length)]; 
) 


return layer; 


该 方法 将 根据 图 层 名 称 、 范 围 以 及 点 的 个 数 三 个 参数 ， 随 机 创建 点 要 素 ， 并 加 入 到 要 素 图 形 图 
层 中 。 在 该 方法 中 ， 先 用 构造 函数 新 建 一 个 要 素 图 形 图 层 对 象 , 在 构造 函数 的 参数 中 指定 要 创建 的 
是 点 要 素 图 层 。 可 以 看 出 ， 这 与 几何 图 形 图 层 不 同 ， 在 几何 图 形 图 层 中 ， 可 以 同时 包含 点 、 线 、 多 
边 形 等 多 类 图 形 。 然 后 利用 其 Columns 属性 在 要 素 中 加 入 两 个 属性 字段 ， 分 别 表示 图 形 符号 的 路 
径 与 名 称 。 最 后 利用 一 个 循环 ， 循 环 加 入 点 要 素 。 在 该 循环 中 ， 直 接 用 Point 的 构造 函数 构造 点 对 
象 ， 并 通过 图 层 对 象 的 Add 方法 返回 点 要 素 行 对 象 ， 然 后 设置 两 个 属性 字段 的 值 。 

需要 读者 在 工程 中 新 建 images 文件 夹 ， 在 其 中 加 入 三 个 小 的 gf 图 片 ， 分别 命名 为 1.gif、 2.gif 


与 3.gif。 可 以 直接 从 本 书 配套 的 源 代码 文件 的 CustomRender 目录 中 拷贝 该 文件 夹 。 


创建 线 要 素 图 形 方法 的 代码 如 下 : 


public static FeatureGraphicsLayer CreatePolylineFeatures( 
string layerName,Envelope env, int count) ( 


if (env == null) 
return null; 


FeatureGraphicsLayer layer = new FeatureGraphicsLayer (FeatureType.Line) 
layer.TableName = layerName; 

layer.Columns.Add("Height", typeof (Double) ); 

layer.Columns.Add("Width", typeof (int)); 

layer.Columns.Add("Color", typeof (System.Drawing.Color)); 
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double maxsize = env.Width / 10; 
for (int 3 = 0; I< count; iti) [I 
double x = env.XMin + rand.NextDouble() * env.Width; 
double y = env.YMin + rand.NextDouble() * env.Height; 
Path p = new Path(); 
p.Points.Add(new Point (x, y)); 
for (int J = 0; j < rand.Next(7) + 3; J+) ( 
x += rand.NextDouble() * maxsize / 5; 
y += rand.NextDouble() * maxsize / 5 - maxsize / 10; 
p.Points.Add(new Point(x, y)); 
) 
Polyline line - new Polyline(); 
line.Paths.Add (p); 


DataRow row = layer.Add(line); 

row["Color"] = getRandomColor(); 

row["Height"] = rand.NextDouble(); 

row["Width"] = Convert.ToInt32(rand.NextDouble() * 5 + 1); 
) 
return layer; 


) 
代码 与 创建 点 要 素 图 层 的 代码 类 似 ， 这 是 多 加 了 几 个 字段 ， 这 几 个 字段 将 用 于 符号 的 设置 。 在 
其 中 调用 的 getRandomColor 方法 ， 得 到 一 个 随机 的 颜色 值 。 该 方法 的 代码 如 下 : 
private static System.Drawing.Color getRandomColor() { 
byte[] rgb = new byte[3]; 


rand.NextBytes (rgb); 
return System.Drawing.Color.FromArgb(rgb[0], rgb[1], rgb[21); 


) 
创建 多 边 形 要 素 图 层 方法 的 代码 如 下 : 


public static FeatureGraphicsLayer CreatePolygonFeatures(string layerName, 
Envelope env, int count) ( 
if (env == null) 
return null; 


FeatureGraphicsLayer layer = 

new FeatureGraphicsLayer (FeatureType.Polygon); 
layer.TableName - layerName; 
layer.Columns.Add("Height", typeof (Double)); 
layer.Columns.Add("Width", typeof (int)); 
layer.Columns.Add("Color", typeof (System.Drawing .Color)); 


double maxsize = env.Width / 10; // 多 边 形 的 最 大 宽度 与 高 度 

for (int i = 0; i < count; itt) f 
double xmin = env.XMin + rand.NextDouble() * env.Width; 
double ymin = env.YMin + rand.NextDouble() * env.Height; 
double rotation = rand.NextDouble() * Math.PI; 
double cosRot = Math.Cos (rotation); 
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double sinRot = Math.Sin(rotation); 
double width = rand.NextDouble() * maxsize; 
double height = rand.NextDouble() * maxsize; 
Ring ring - new Ring(); 
ring.Points.Add(new Point(xmin, ymin)); 
ring.Points.Add (new Point (xmin + cosRot * width, ymin + sinRot * width)); 
ring.Points.Add(new Point(xmin + cosRot * width + sinRot * height, 
ymin + sinRot * width - cosRot * height)); 
ring.Points.Add(new Point(xmin * sinRot * height, 
ymin - cosRot * height)); 
ring.Points.Add(new Point(xmin, ymin)); 
Polygon p = new Polygon(); 
p.Rings.Add (ring); 


DataRow row = layer.Add(p); 

row["Color"] = getRandomColor(); // 随机 颜色 

row["Height"] = rand.NextDouble(); 

row["Width"] = Convert.ToInt32(rand.NextDouble() * 5 + 1); 
) 


return layer; 


创建 多 边 形 对 象 时 ， 需 要 先 创 建 Ring 对 象 ， 在 该 对 象 中 加 入 点 对 象 ， 然 后 利用 多 边 形 对 象 的 
Rings 属性 的 Add 方法 加 入 Ring 对 象 。 

上 面 几 个 方法 是 随机 生成 几何 要 素 的 空间 位 置 .通常 是 利用 一 个 查询 得 到 一 个 图 层 中 所 有 要 素 
或 部 分 要 素 , 然后 构造 一 个 要 素 图 形 图 层 。 下 面 的 AttributeQuery 方法 ， 就 用 于 从 USAMap 地 图 资 
源 中 从 美国 州 级 行政 区 划 图 层 中 得 到 所 有 要 素 ， 对 于 属性 属性 ， 只 保留 POP1999 (1999 年 各 州 人 
口 数 ) ， 并 按照 参数 指定 分 类 的 个 数 ， 进 行 分 类 。AttributeQuery 方法 的 代码 如 下 : 


public static FeatureGraphicsLayer AttributeQuery (Map map, int nCount) 


{ 


IGISFunctionality gisfunc = map.GetFunctionality ("USAMap"); 
if (gisfunc -- null) 
return null; 


IGISResource gisresource = gisfunc.Resource; 
bool supportquery = 
gisresource.SupportsFunctionality (typeof (IQueryFunctionality)); 
if (!supportquery) 
return null; 


IQueryFunctionality qfunc; 

qfunc = gisresource.CreateFunctionality( 
typeof(IQueryFunctionality), null) 
as IQueryFunctionality; 


SpatialFilter spatialfilter = new SpatialFilter(); 
spatialfilter.ReturnADFGeometries = false; 
spatialfilter.MaxRecords - 100; 
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spatialfilter.WhereClause = ""; 
spatialfilter.SubFields.Add("POP1999"); 


System.Data.DataTable datatable = qfunc.Query(null, "1", spatialfilter); 
if (datatable == null) 
return null; 


return PolygonFeatureFormTable (map, datatable, nCount); 


private static FeatureGraphicsLayer PolygonFeatureFormTable (Map map, 
DataTable datatable, int nCount) ( 
FeatureGraphicsLayer layer - null; 
layer = new FeatureGraphicsLayer (FeatureType.Polygon); 
layer.TableName = datatable.TableName; 
layer.Columns.Add("POP1999", typeof (Double)); 


DataRowCollection drs = datatable.Rows; 

int shpind - -1; 

for (int i 0; i < datatable.Columns.Count; i++) ( 

if (datatable.Columns[i].DataType == 

typeof (ESRI.ArcGIS.ADF.Web.Geometry.Geometry)) { 
// 找到 Geometry 字段 的 序号 
shpind = i; 
break; 


try í 
double maxValue, minValue; 
MaxMinValue(datatable, "POP1999", out maxValue, out minValue); 
double dist = maxValue - minValue; 
foreach (DataRow dr in datatable.Rows) ( 
ESRI.ArcGIS.ADF.Web.Geometry.Geometry geom = dr[shpind] 
as ESRI.ArcGIS.ADF.Web.Geometry.Geometry; 


DataRow row = layer .Add (geom); 
double fieldValue - (double)dr["POP1999"]; 
row["POP1999"] = nCount * (fieldValue - minValue) / dist; 


) 


catch (InvalidCastException ice) ( 
throw new Exception("No geometry available in datatable"); 


return layer; 


private static void MaxMinValue (System.Data.DataTable datatable, 
string field, out double maxValue, out double minValue) { 
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maxValue = 0; 
minValue = 999999999; 
foreach (DataRow dr in datatable.Rows) { 
double fieldValue = (double)dr[field]; 
if (maxValue « fieldValue) 
maxValue - fieldValue; 
if (minValue > fieldValue) 
minValue = fieldValue; 


7.32 自 定义 着 色 器 


在 Web ADF 中 ， 人 允许 为 图 形 图 层 在 默认 符号 之 外 ， 创 建 自 定义 的 着 色 器 。 自 定义 着 色 器 需要 
实现 IRender 接口 。 通 过 该 接口 ， 可 以 完全 利用 .NET 中 System.Drawing 命名 空间 中 的 类 ， 来 控制 
要 素 如 何在 地 图 中 显示 。 


1. IRender 接口 


IRender 接口 中 包含 5 个 方法 , 但 是 如 果 不 需要 支持 Toc 控件 , 其 实 真正 需要 的 只 是 一 个 方法 ， 
可 以 使 用 非常 简单 的 代码 实现 其 他 4 个 方法 。 
这 5 个 方法 分 别 是 : 


O ”GenerateSwatches 一 一 为 该 着 色 器 在 Toc 控件 中 的 显示 创建 样本 ; 

口 、GetAllSymbols 一 一 返回 该 对 象 使 用 的 所 有 要 素 符号 对 象 ; 

口 ”GetMaxSwatchDimension 一 一 得 到 该 着 色 器 创建 的 图 例 样本 的 最 大 的 宽度 与 高 度 ; 
O Clone 一 一 返回 该 着 色 器 的 拷贝 ; 

口 Render 一 一 将 几何 对 象 绘制 为 图 形 。 


在 App Code 文件 夹 中 新 增加 一 个 类 ， 命 名 为 RendererBase。 我 们 用 该 类 实现 最 简单 的 着 
色 器 。 

先 在 其 头 部 加 入 如 下 代码 ， 引 用 命名 空间 : 

using ESRI.ArcGIS.ADF.Web.Display.Renderer; 

using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.Display.Symbol; 

using ESRI.ArcGIS.ADF.Web.Display.Swatch; 

using System.Drawing.Drawing2D; 

using System.Collections.Generic; 


将 类 的 声明 代码 修改 为 如 下 : 
public abstract class RendererBase : IRenderer 
类 的 实现 代码 如 下 : 


public virtual SwatchCollection GenerateSwatches (SwatchInfo swatchInfo, 
string fileName, string minScale, string maxScale) ( 
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return new ESRI.ArcGIS.ADF.Web.Display.Swatch.SwatchCollection(); 


public virtual void GetAllSymbols (List«FeatureSymbol» symbols) ( 
H 


public virtual void GetMaxSwatchDimensions (ref int width, ref int height) ( 
) 


public object Clone() { 
return this.MemberwiseClone() as RendererBase; 


public abstract void Render(DataRow row, System.Drawing.Graphics graphics, 
DataColumn geometryColumn); 


对 于 最 简单 的 着 色 器 ， 可 以 只 实现 前 4 个 方法 。 
我 们 最 关心 的 是 Render 方法 ， 该 方法 的 第 一 个 参数 是 需要 绘制 的 行 ， 第 二 个 参数 是 绘制 图 形 
对 象 ， 第 三 个 参数 是 几何 数据 所 在 字段 的 名 称 。 


2. 自 定义 点 要 素 着 色 器 


在 App. Code 文件 夹 中 新 加 入 一 类 , 命名 为 SimplePointRenderer。 该 类 将 实现 用 小 的 gif 
图 标 来 绘制 点 要 素 。 在 该 类 其 头 部 加 入 如 下 命名 空间 的 引用 : 

using ESRI.ArcGIS.ADF.Web; 

using ESRI.ArcGIS.ADF.Web.Geometry; 


using ESRI.ArcGIS.ADF.Web.Display.Swatch; 
using ESRI.ArcGIS.ADF.Web.Display.Symbol; 


将 类 的 声明 修改 为 如 下 代码 ， 指 定 继承 RendererBase 25: 
public class SimplePointRenderer : RendererBase 
然后 加 入 一 个 表示 图 标 路 径 字 段 的 属性 ， 代 码 如 下 : 


private string imagePathColumn = "ImagePath"; 
public string ImagePathColumn ( 
get ( 
return imagePathColumn; 


) 


set ( 
imagePathColumn - value; 
) 
} 
该 类 的 Render 方法 代码 如 下 : 


public override void Render (DataRow row, 
System.Drawing.Graphics graphics, DataColumn geometryColumn) { 
if (row == null || graphics == null || geometryColumn == null) 
return; 
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Geometry geometry = row[geometryColumn] as Geometry; 
if (geometry == null || ! (geometry is ESRI.ArcGIS.ADF.Web.Geometry.Point)) 
return; 


Point p = geometry as Point; 
if (row.Table.Columns.Contains (imagePathColumn)) { 
string imagelcon = row[imagePathColumn].ToString(); 
alu 
(!System.IO.File.Exists(System.Web.HttpContext.Current.Server.MapPath (imagelco 
n))) t 
System.Diagnostics.Debug.Fail("Image path '" + imageIcon + "' not 
found"); 
return; 
) 
using (System.Drawing.Image img = System.Drawing.Image.FromFile( 
System.Web.HttpContext.Current.Server.MapPath(imageIcon))) ( 
graphics.DrawImageUnscaled (img, Convert.ToInt32 (p.X), 
Convert.ToInt32(p.Y)); 
img.Dispose(); 


) 


) 


在 自 定义 着 色 器 中 首先 要 做 的 是 ， 得 到 需要 绘制 的 几何 对 象 。 然 后 利用 System.Drawing 中 的 
类 在 点 的 位 置 绘制 一 个 图 标 。 
Graphics 类 提供 了 DrawImage 与 DrawImageUnscaled 方法 来 绘制 图 像 ,前 者 在 指定 位 置 并 且 按 
指定 大 小 绘制 指定 的 图 像 , 后 者 在 由 坐标 对 指定 的 位 置 , 使 用 图 像 的 原始 物理 大 小 绘制 指定 的 图 像 。 
支持 在 Toc 控件 中 显示 图 例 的 方法 的 代码 如 下 : 
public override SwatchCollection GenerateSwatches (SwatchInfo swatchInfo, 
string fileName, string minScale, string maxScale) ( 
SwatchCollection swatches - new SwatchCollection(); 
for (int I = 17 1 <= 37 IF) { 
CartoImage img = new CartoImage( 
HttpContext.Current.Server.MapPath( 
string.Format ("-/images/(0).gif", i))); 
Swatches .Add (new Swatch (img, "Marker $" + i.ToString(), null, null)); 
i 


return swatches; 


) 

在 Default.aspx 页 面 中 增加 一 地 图 资源 管理 器 控件 、 一 地 图 控件 与 一 Toc 控件 。 通 过 地 图 资源 
管理 器 控件 的 MapResourcesItem 属性 设置 对 话 框 ， 先 加 入 一 个 GraphicsLayer 类 型 的 资源 ， 命 名 为 
GraphicsDataSource， 然 后 加 入 USAMap 地 图 资源 。 

通过 工程 的 右键 菜单 的 Add ArcGIS Identity 命令 ， 加 入 连接 USAMap 地 图 资源 的 身份 信息 。 

在 Default 类 的 头 部 加 入 如 下 命名 空间 引用 : 


using ESRI.ArcGIS.ADF.Web.Display.Graphics; 
using ESRI.ArcGIS.ADF.Web.Geometry; 
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using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.Web.DataSources; 


然后 在 _Default 类 中 加 入 Page 对 象 的 PreRender 事件 处 理 方法 ， 代 码 如 下 : 


protected void Page PreRender(object sender, EventArgs e) 
t 
if (IsPostBack) 
return; 


MapResourceItem resourceItem = 
MapResourceManagerl.ResourceItems.Find ("GraphicsDataSource"); 
ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource resource - 
resourceItem.Resource as 
ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource; 
if (resource !- null) 
t 
FeatureGraphicsLayer layer - 
GenerateGraphicsHelper.CreatePointFeatures( 
"points", Mapl.Extent, 50); 
if (layer !- null) 


// 应 用 自 定义 着 色 器 
SimplePointRenderer renderer = new SimplePointRenderer(); 
renderer.ImagePathColumn = "imagePath"; // 包含 图 表 所 在 文件 的 字段 名 


layer.Renderer = renderer; //Assign renderer 


// 增加 图 层 

if (resource.Graphics.Tables.Contains ("points")) 
resource.Graphics.Tables.Remove ("points"); 

resource.Graphics.Tables.Add (layer); 


) 


Map1.RefreshResource ("GraphicsDataSource"); 


) 

在 上 述 代 码 中 , 通过 调用 Courier New 类 的 CreatePointFeatures 方法 , 创建 一 个 包含 50 个 点 要 
素 的 图 层 ， 然 后 利用 我 们 自 定 义 的 点 要 素 着 色 器 ， 并 把 该 图 层 加 入 到 地 图 资源 中 。 最 后 调用 
RefreshResource 方法 来 刷新 地 图 。 

编译 并 运行 程序 ， 效 果 如 图 7.3 所 示 。 
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E73 自 定 义 点 要 素 着 色 器 
3.， 自 定义 线 要 素 着 色 器 
在 App. Code 文件 夹 中 新 加 入 一 类 ， 命 名 为 LinecolorRenderer。 在 该 类 的 文件 头 部 加 入 
如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web.Geometry; 
using ESRI.ArcGIS.ADF.Web.Display.Swatch; 
using ESRI.ArcGIS.ADF.Web.Display.Symbol; 


将 类 的 声明 修改 为 如 下 代码 ， 指 定 继承 Courier New 25: 
public class LineColorRenderer: RendererBase 
然后 加 入 一 表示 符号 的 线 的 颜色 与 宽度 字段 名 称 的 属性 ， 代 码 如 下 : 


private string lineColorColumn - "Color"; 
public string LineColorColumn 
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{ 
get 
t 
return lineColorColumn; 
) 
set 
{ 
lineColorColumn = value; 
) 
private string lineThicknessColumn - "Width"; 


public string LineThicknessColumn 


{ 
get 
{ 
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return lineThicknessColumn; 


set 
t 
lineThicknessColumn - value; 
) 
} 
该 类 的 Render 方法 代码 如 下 : 


public override void Render (DataRow row, 
System.Drawing.Graphics graphics, System.Data.DataColumn geometryColumn) 


if (row == null || graphics == null || geometryColumn == null) 
return; 

Geometry geometry = row[geometryColumn] as Geometry; 

if (geometry == null) 
return; 


System.Drawing.Color lineColor = System.Drawing.Color.Black; 
float lineWidth = 1; 
if (row.Table.Columns.Contains (LineThicknessColumn)) 
{ 
float.TryParse (row[LineThicknessColumn] .ToString(), out lineWidth); 
} 
if (row.Table.Columns.Contains (LineColorColumn) 
&& row[LineColorColumn] is System.Drawing.Color) 


lineColor = (System.Drawing.Color)row[LineColorColumn]; 
) 
if (geometry is Polygon) 
Utility.DrawPolygon (graphics, geometry as Polygon, 
lineColor, lineWidth); 
else if (geometry is Polyline) 
Utility.DrawPolyline(graphics, geometry as Polyline, 
lineColor, lineWidth); 
} 


在 该 方法 中 又 利用 了 Utility 类 的 两 个 方法 ， 分 别 绘制 多 边 形 与 线 。 
在 App_Code 文件 夹 中 新 加 入 一 类 ， 命 名 为 Utility。 在 该 类 的 文件 头 部 加 入 如 下 命名 空间 
的 引用 : 


using System.Drawing.Drawing2D; 
using System.Drawing; 


绘制 多 边 形 与 线 的 方法 及 其 相关 方法 的 代码 如 下 : 


public static void DrawPolygon (Graphics g, 
ESRI.ArcGIS.ADF.Web.Geometry.Polygon p, Color color, float width) 
t 

DrawPolygon(g, p, color, width, 0, 0); 
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public static void DrawPolygon (Graphics g, 
ESRI.ArcGIS.ADF.Web.Geometry.Polygon p, 
Color color, float width, int offsetX, int offsetY) 
t 
if (p == null) 
return; 


using (GraphicsPath path - Utility.PolygonToPath(p, offsetX, offsetY)) 
{ 


using (Pen pen = new Pen(color, width)) 
{ 
g.DrawPath(pen, path); 
pen.Dispose(); 


) 
path.Dispose(); 


public static GraphicsPath PolygonToPath( 
ESRI.ArcGIS.ADF.Web.Geometry.Polygon polygon) 


return PolygonToPath (polygon, 0, 0); 


public static GraphicsPath PolygonToPath( 
ESRI.ArcGIS.ADF.Web.Geometry.Polygon polygon, int offsetX, int offsetY) 
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GraphicsPath path = new GraphicsPath(); 
foreach (ESRI.ArcGIS.ADF.Web.Geometry.Ring p in polygon.Rings) 


t 
path.AddPolygon (pointCollectionToPointArray( 
p.Points, offsetX, offsetY)); 
foreach (ESRI.ArcGIS.ADF.Web.Geometry.Hole ring in p.Holes) 
path.AddPolygon (pointCollectionToPointArray (ring.Points, offsetX, 
offsetY)); 
) 


return path; 


public static void DrawPolyline (Graphics g, 
ESRI.ArcGIS.ADF.Web.Geometry.Polyline line, Color color, float width) 
t 
if (line == null) return; 
using (GraphicsPath path = Utility.PolylineToPath(line)) 
{ 
using (Pen pen = new Pen(color, width)) 
{ 
g.DrawPath(pen, path); 
pen.Dispose(); 


) 
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path.Dispose(); 


) 


public static GraphicsPath PolylineToPath( 
ESRI.ArcGIS.ADF.Web.Geometry.Polyline polyline) 


t 
Graph. 


icsPath path = new GraphicsPath(); 


foreach (ESRI.ArcGIS.ADF.Web.Geometry.Path line in polyline.Paths) 


{ 


path.AddLines (pointCollectionToPointArray(line.Points, 0, 0)); 


) 


return path; 


} 


private static Point[] pointCollectionToPointArray( 
ESRI.ArcGIS.ADF.Web.Geometry.PointCollection points, 
int offsetX, int offsetY) 


1 
Point 
for ( 
{ 


[] pointArr = new Point[points.Count]; 
int i = 0; i < points.Count; itt) 


pointArr[i] = new Point(Convert.ToInt32(points[i].X - offsetX), 


) 


Convert.ToInt32(points[i].Y - offsetY)); 


return pointArr; 


) 


由 于 在 System.Drawing 中 只 提供 了 DrawPath 方法 来 绘制 GraphicsPath 类 表示 路 径 ， 因 此 需 : 


先 将 Web ADF 


中 的 Polyline 与 Polygon 对 象 转换 为 路 径 。 


路 径 可 由 任意 数目 的 图 形 〈 子 路 径 ) 组 成 。 每 一 图 形 都 是 由 一 系列 相互 连接 的 直线 和 曲线 或 几 
何 形状 基 元 构成 的 。 图 形 的 起 始点 是 相互 连接 的 一 系列 直线 和 曲线 中 的 第 一 点 。 终 结 点 是 该 序列 中 
的 最 后 一 点 。 几 何 形状 基 元 的 起 始点 和 终结 点 都 是 由 基 元 规范 定义 的 。 

在 工程 新 加 入 一 ASPNET 页 面 ， 命 名 为 CustomLineRender。 

在 CustomLineRender.aspx 页 面 中 增加 一 地 图 资源 管理 器 控件 、 一 地 图 控件 与 一 Toc 控件 。 通 


过 地 图 资源 管理 


器 控件 的 MapResourcesItem 属性 设置 对 话 框 ， 先 加 入 一 个 GraphicsLayer 类 型 的 资 


源 ， 命 名 为 GraphicsDataSource， 然 后 加 入 USAMap 地 图 资源 。 
在 CustomLineRender 类 的 头 部 加 入 如 下 命名 空间 引用 : 


using ESRI.ArcGIS.ADF.Web.Display.Graphics; 
using ESRI.ArcGIS.ADF.Web.Geometry; 


然后 在 CustomLineRender 类 中 加 入 Page 对 象 的 PreRender 事件 处 理 方法 ， 代 码 如 下 : 


protected void Page PreRender(object sender, EventArgs e) 


{ 
ne 


sPostBack) 


return; 
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编译 并 运行 程序 ， 程 序 运行 效果 如 图 7.4 所 示 。 
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图 7.4 自 定义 线 要 素 着 色 器 
4. 注 记 着 色 器 


注 记 着 色 器 就 是 要 在 地 图 上 绘制 文本 信息 。 

在 App Code 文件 夹 中 新 加 入 一 类 , 命名 为 LabelPointRenderer. 在 该 类 其 头 部 加 入 如 下 
命名 空间 的 引用 : 

using ESRI.ArcGIS.ADF.Web.Geometry; 


using ESRI.ArcGIS.ADF.Web.Display.Swatch; 
using ESRI.ArcGIS.ADF.Web.Display.Symbol; 


将 类 的 声明 修改 为 如 下 代码 ， 指 定 继承 RendererBase 25: 


public class LabelPointRenderer: RendererBase 


然后 加 入 表示 背景 颜色 、 字 体 等 的 属性 ， 代 码 如 下 : 


public LabelPointRenderer() : base() 


{ 
Font = new System.Drawing.Font("Arial", 8f); 


private string labelColumn - "Name"; 
public string LabelColumn 


get 
{ 

return labelColumn; 
} 
set 
{ 

labelColumn = value; 
) 
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} 
Render 方法 的 代码 如 下 : 


public override void Render(System.Data.DataRow row, 
System.Drawing.Graphics graphics, System.Data.DataColumn geometryColumn) 


i 


if (row == null || graphics == null || geometryColumn == null) 
return; 

Geometry geometry = row[geometryColumn] as Geometry; 

if (geometry == null || ! (geometry is ESRI.ArcGIS.ADF.Web.Geometry.Point)) 
return; 


ESRI.ArcGIS.ADF.Web.Geometry.Point p - 
geometry as ESRI.ArcGIS.ADF.Web.Geometry.Point; 
if (row.Table.Columns.Contains (LabelColumn)) 


string text = row[LabelColumn].ToString(); 

// 得 到 文本 的 大 小 

System.Drawing.SizeF size = graphics.MeasureString(text, Font); 
int margin = 2; // 文本 周围 的 边 距 

int arrowSize = 5; // 指向 点 坐标 的 箭头 的 大 小 

int width = (int)size.Width + margin * 2; 

int height = (int)size.Height + margin * 2; 


System.Drawing.Drawing2D.GraphicsPath path = 

new System.Drawing.Drawing2D.GraphicsPath() 
int x - (int)p.X; 
int y = (int)p.Y; 
System.Drawing.Point[] pnts = new System.Drawing.Point[8]; 
pnts[0] = new System.Drawing.Point(x, y); // 起 点 
pnts[1] new System.Drawing.Point(x - arrowSize, y - arrowSize); 
pnts[2] = new System.Drawing.Point(x - width / 2, pnts[1].Y); 
pnts[3] = new System.Drawing.Point(pnts[2].X, pnts[2].Y - height); 
pnts[4] = new System.Drawing.Point(pnts[3].X + width, pnts[3].Y):; 
pnts[5] = new System.Drawing.Point(pnts[4].X, pnts[4].Y + height); 
pnts[6] = new System.Drawing.Point(x + arrowSize, y - arrowSize); 
pnts[7] = new System.Drawing.Point(x, y); // 终点 
path.AddPolygon (pnts); 
// 绘制 背景 
graphics.FillPath (new System.Drawing.SolidBrush (BackgroundColor), 


path); 
// 绘制 边线 
graphics.DrawPath (new System.Drawing.Pen(OutlineColor), path); 
// 绘制 属性 
graphics.DrawString(text, Font, 
new System.Drawing.SolidBrush (FontColor), 
new System.Drawing.PointF(x - width / 2 + margin, y - height - 
arrowSize + margin)); 


) 
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Graphics 类 的 DrawString 方法 用 于 绘制 文本 。 这 个 函数 有 多 个 重 载 版 本 ， 但 是 它们 都 需要 以 
下 4 个 元 素 : 绘制 的 字符 串 〈String) 、 使 用 的 字体 对 象 (Fon) 、 为 填充 字体 所 要 使 用 的 刷子 对 
象 (Brush) 以 及 文本 绘制 的 位 置 (PointF ) ， 这 个 位 置 可 以 通过 一 个 义 坐标 与 一 个 Y 坐标 、 一 个 
点 或 者 是 一 个 有 边界 的 和 矩形 表示 。 

在 工程 新 加 入 一 ASP.NET 页 面 ， 命 名 为 LaberRenderer。 

在 LaberRenderer.aspx 页 面 中 增加 一 地 图 资源 管理 器 控件 、 一 地 图 控件 与 一 Toc 控件 。 通 过 地 
图 资源 管理 器 控件 的 MapResourcesItem 属性 设置 对 话 框 ， 先 加 入 一 个 GraphicsLayer 类 型 的 资源 ， 
命名 为 GraphicsDataSource， 然 后 加 入 USAMap 地 图 资源 。 

在 LabelRenderer 类 的 头 部 加 入 如 下 命名 空间 引用 : 

using ESRI.ArcGIS.ADF.Web.Display.Graphics; 

using ESRI.ArcGIS.ADF.Web.Geometry; 


using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.Web.DataSources.Graphics; 


然后 在 LabelRenderer 类 中 加 入 Page 对 象 的 PreRender 事件 处 理 方法 ， 代 码 如 下 : 


protected void Page PreRender(object sender, EventArgs e) 


{ 


if (IsPostBack) 
return; 


MapResourceItem resourceItem = 
MapResourceManagerl.ResourceItems.Find ("GraphicsDataSource"); 

MapResource resource = resourcelItem.Resource as MapResource; 

if (resource !- null) 


{ 


FeatureGraphicsLayer layer = 


GenerateGraphicsHelper.CreatePointFeatures( 
"points", Mapl.Extent, 20); 


if (layer !- null) 


{ 


} 
} 


// 应 用 着 色 器 

LabelPointRenderer renderer = new LabelPointRenderer(); 

renderer.LabelColumn - "RandomName"; 

renderer.BackgroundColor - 
System.Drawing.Color.FromArgb(255, 255, 255, 200); 

layer.Renderer - renderer; 


// 增加 图 层 

if (resource.Graphics.Tables.Contains ("points")) 
resource.Graphics.Tables.Remove ("points"); 

resource.Graphics.Tables.Add (layer); 


Mapl.RefreshResource ("GraphicsDataSource"); 
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编译 并 运行 程序 ， 运 行 效果 如 图 7.5 所 示 。 


J Untitled Page — Microsoft Internet Explorer 
文件 EE) REO FEV BEA IAW 帮助 0 
地 址 四 ) [Æ] http: //Locathost/CustonRender/LabelRenderer. aspx 


GraphicsDataSource ^ 
vpoints 

USAMap 

ushigh 


states 
counties 

国 Alabama 
回 Alaska 
DArizona 
Arkansas 
California 
Colorado 


EJ 本 地 Intranet 


图 7.5 自 定义 注 记 着 色 器 
5. 自 定义 范围 专题 图 着 色 器 


在 一 个 专题 图 中 , 范围 专题 图 着 色 器 将 数值 集合 成 一 个 个 离散 域 , 并 且 为 每 个 域 指定 一 个 符号 。 
下 面 是 一 个 描述 某 地 人 口 数量 的 例子 , 假设 要 做 一 张 地 图 , 并 且 想 用 五 种 不 同 颜色 描述 人 口 数 的 五 
MEIR: 0 一 9999 人 用 黄色 标注 ; 10000 一 49999 人 的 用 浅 橙色 ; 50000—99999 人 的 用 橙色 ; 100000 
人 以 上 的 用 红色 。 

在 App Code 文件 夹 中 新 加 入 一 类 ， 命 名 为 GraduatedColorRenderer。 在 该 类 其 头 部 加 
入 如 下 命名 空间 的 引用 : 

using ESRI.ArcGIS.ADF.Web.Display.Renderer; 

using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.Display.Symbol; 

using System.Drawing.Drawing2D; 

using System.Collections.Generic; 

using ESRI.ArcGIS.ADF.Web.Display.Swatch; 


将 类 的 声明 修改 为 如 下 代码 ， 指 定 继承 RendererBase 25: 
public class GraduatedColorRenderer: RendererBase 
然后 加 入 一 表示 开始 颜色 、 终 止 颜色 等 属性 ， 代 码 如 下 : 


private System.Drawing.Color startColor = System.Drawing.Color.Red; 
public System.Drawing.Color StartColor 
t 
get 
t 
return startColor; 
) 


set 
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colorColumnName = value; 


} 
Render 方法 及 其 服务 方法 的 代码 如 下 : 


public override void Render (DataRow row, System.Drawing.Graphics graphics, 
DataColumn geometryColumn) 


if (row == null || graphics == null || geometryColumn == null) 
return; 


Geometry geometry = row[geometryColumn] as Geometry; 
if (geometry == null || geometry is ESRI.ArcGIS.ADF.Web.Geometry.Point) 
return; 


if (!string.IsNullOrEmpty (ColorColumnName) 
&& row.Table.Columns.Contains (ColorColumnName)) 


double value - 0; 
if (double.TryParse (row[ColorColumnName].ToString(), out value)) 
{ 
System.Drawing.Color color = interpolateColor (value); 
if (geometry is Polygon) 
t 
Utility.FillPolygon(graphics, geometry as Polygon, color, 0, 0, 


) 
else if (geometry is Polyline) 
t 
Utility.DrawPolyline (graphics, geometry as Polyline, color, 2); 


private System.Drawing.Color interpolateColor(double value) 
( 
if (value «- minValue) 
return startColor; 
if (value »- maxValue) 
return endColor; 
double frac - (value - minValue) / (maxValue - minValue); 


int r = (int)Math.Round(startColor.R * (1 - frac) + endColor.R * (frac)); 
int g = (int)Math.Round(startColor.G * (1 - frac) + endColor.G * (frac)); 
int b = (int)Math.Round(startColor.B * (1 - frac) + endColor.B * (frac)); 
int a = (int)Math.Round(startColor.A * (1 - frac) + endColor.A * (frac)); 
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return System.Drawing.Color.FromArgb(a, r, g, b); 
} 


在 上 面 的 代码 中 通过 调用 Utility 类 的 FillPolygon 与 DrawPolyline 来 绘制 每 个 要 素 的 。 
DrawPolyline 方法 已 经 在 前 面 就 已 经 加 入 了 ，FillPolygon 方法 及 其 辅助 方法 的 代码 如 下 : 


public static void FillPolygon (Graphics g, 
ESRI.ArcGIS.ADF.Web.Geometry.Polygon p, 
Color color, int transparency, int offsetX, int offsetY) 
t 
if (p == null) 
return; 


using (GraphicsPath path - Utility.PolygonToPath(p, offsetX, offsetY)) 
{ 
Color fillColor = 
Color.FromArgb(TransparencyToAlpha (transparency), color); 
using (SolidBrush brush = new SolidBrush(fillColor)) 
{ 
g.FillPath(brush, path); 
brush.Dispose(); 
) 
path.Dispose(); 


) 


public static byte TransparencyToAlpha (double percentage) 
i 
double value - 0; 
value - 100 - percentage; 
value - value / 100; 
value - value * 255; 
if (value « 0) 
value = 0; 
else if (value » 255) 
value = 255; 
return (byte)value; 


) 

由 于 这 里 绘制 多 边 形 需要 的 是 填充 效果 ， 因 此 调用 的 是 Graphics 类 的 FillPath 方法 ， 填 充 
GraphicsPath 的 内 部 。 

在 工程 新 加 入 一 ASPNET 页 面 ， 命 名 为 GraduatedRenderer。 

在 GraduatedRenderer.aspx 页 面 中 增加 一 地 图 资源 管理 器 控件 、 一 地 图 控件 与 一 Toc 控件 。 通 
过 地 图 资源 管理 器 控件 的 MapResourcesItem 属性 设置 对 话 框 ， 先 加 入 一 个 GraphicsLayer 类 型 的 资 
源 ， 命 名 为 GraphicsDataSource， 然 后 加 入 USAMap 地 图 资源 。 

在 GraduatedRenderer 类 的 头 部 加 入 如 下 命名 空间 引用 : 


using ESRI.ArcGIS.ADF.Web.Display.Graphics; 
using ESRI.ArcGIS.ADF.Web.Geometry; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
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using ESRI.ArcGIS.ADF.Web.DataSources.Graphics; 


然后 在 GraduatedRenderer 类 中 加 入 Page 对 象 的 PreRender 事件 处 理 方法 ， 代 码 如 下 : 


protected void Page PreRender (object sender, EventArgs e) 
i 
if (IsPostBack) 
return; 


MapResourceItem resourceItem = 
MapResourceManagerl.ResourceItems.Find ("GraphicsDataSource"); 
MapResource resource = resourceItem.Resource as MapResource; 
if (resource !- null) 
{ 
FeatureGraphicsLayer layer = 
GenerateGraphicsHelper.AttributeQuery (Mapl, 5); 
addLayer (resource, layer); 
) 


Mapl.RefreshResource ("GraphicsDataSource"); 


private static void addLayer (MapResource resource, FeatureGraphicsLayer layer) 
t 
if (layer !- null) 
{ 
// 应 用 着 色 器 
GraduatedColorRenderer renderer = new GraduatedColorRenderer(); 
renderer.ColorColumnName = "POP1999"; // 用 于 插值 的 字段 名 称 
renderer.StartColor = System.Drawing.Color.Blue; 
renderer.EndColor System.Drawing.Color.Red; 
renderer.MinValue - 1; 
renderer.MaxValue 6; 
layer.Renderer - renderer; 


// 增加 图 层 

if (resource.Graphics.Tables.Contains (layer.TableName)) 
resource.Graphics.Tables.Remove (layer.TableName); 

resource.Graphics.Tables.Add (layer); 


编译 并 运行 程序 ， 运 行 效果 如 图 7.6 所 示 。 
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图 7.6 自 定义 范围 专题 图 着 色 器 


6. 自 定 义 三 维 着 色 器 


利用 范围 专题 图 着 色 器 ,可 以 大 致 看 出 各 地 区 人 口 数 量 的 分 布 情况 , 但 是 还 不 是 太 直观 。 最 直 
观 的 方式 是 利用 三 维 方式 。 本 小 节 将 带领 读者 分 步骤 完成 一 个 三 维 着 色 器 。 

在 App Code 文件 夹 中 新 加 入 一 类 ， 命名 为 SimpleRenderer3D。 在 该 类 的 文件 头 部 加 入 如 
下 命名 空间 的 引用 : 

using ESRI.ArcGIS.ADF.Web.Display.Renderer; 

using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.Display.Symbol; 

using System.Drawing.Drawing2D; 


using System.Collections.Generic; 
using System.Drawing; 


将 类 的 声明 修改 为 如 下 代码 ， 指 定 继承 RendererBase 25: 
public class SimpleRenderer3D: RendererBase 
然后 加 入 表示 填充 颜色 、 边 线 颜 色 、 透 明度 等 的 属性 ， 代 码 如 下 : 


// 填充 颜色 

private Color fillColor = Color.White; 
public Color FillColor 

{ 


get 
{ 


return fillColor; 


fillColor - value; 
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lightDirection - value / 180 * Math.PI; 


} 
三 维 着 色 器 主要 实现 了 IRender 接口 的 两 个 方法 ， 它 们 的 代码 如 下 : 


public override void GetAllSymbols( 
System.Collections.Generic.List«FeatureSymbol^ symbols) 


t 
SimpleFillSymbol symbol = new SimpleFillSymbol(FillColor, 
OutlineColor, PolygonFillType.Solid); 
symbol.Transparency = Transparency; 
symbols .Add (symbol); 
} 


public override void Render (DataRow row, Graphics graphics, 
DataColumn geometryColumn) 
{ 
if (row == null || graphics == null || geometryColumn == null) 
return; 


Geometry geometry = row[geometryColumn] as Geometry; 
if (geometry == null 
|| geometry is ESRI.ArcGIS.ADF.Web.Geometry.Point) 
return; 
double height = MaxHeight; 
// 得 到 高 度 字段 
if (!string.IsNullOrEmpty (HeightColumnName) 
&& row.Table.Columns.Contains (HeightColumnName)) 


double.TryParse(row[HeightColumnName].ToString(), out height); 


) 
height *- scaleHeight; //Multiply height with scale multiplier 


if (height » maxHeight) 
height = maxHeight; //Clip values beyong maxheight 


drawGraphic(geometry, graphics, height); 
) 


在 上 述 代 码 中 , 主要 调用 drawGraphic 方法 来 实现 三 维 绘制 要 素 的 。 该 方法 及 其 相关 代码 如 下 : 


#region 三 维 绘制 要 素 


private void drawGraphic(Geometry geometry, Graphics g, double height) 
t 
if (geometry is ESRI.ArcGIS.ADF.Web.Geometry.Envelope) //Convert to polygon 
t 
Polygon polygon = new Polygon(); 
polygon.Rings.Add(new Ring(geometry as Envelope)); 
geometry = polygon; 
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1 
if (geometry is Polygon) 
ii 
drawPolygon(g, geometry as Polygon, height); 


private struct LineSegment : IComparable«LineSegment^ 
t 
public ESRI.ArcGIS.ADF.Web.Geometry.Point Start; 
public ESRI.ArcGIS.ADF.Web.Geometry.Point End; 
public double Direction; 


public int CompareTo(LineSegment other) 
i 
return Math.Min(this.End.Y, this.Start.Y).CompareTo( 
Math.Min(other.End.Y, other.Start.Y)); 


} 
// 将 一 点 集合 转换 为 连接 这 些 点 的 线段 列表 


private void getLineSegments (PointCollection points, 
ref List<LineSegment> list) 
t 
for (int i = 1; i < points.Count; i-*) 
{ 
LineSegment line = new LineSegment (); 
line.Start = points[i - 1]; 
line.End = points[i]; 
line.Direction - getLineDirection(line.Start, line.End); 
list.Add (line); 


ji 


// 实现 三 维 绘制 要 素 的 核心 方法 
private void drawPolygon(Graphics g, Polygon polygon, double height) 
t 
foreach (Ring p in polygon.Rings) 
{ 
List<LineSegment> list = new List«LineSegment» (p.Points.Count); 
getLineSegments (p.Points, ref list); 
foreach (Hole hole in p.Holes) 
{ 
getLineSegments (hole.Points, ref list); 
} 
list.Sort(); // 进行 排序 
// 第 一 步 ， 绘 制 反面 
if (Transparency > 0) //ignore if not see-through 
t 


foreach (LineSegment line in list) 
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if (Math.Abs(line.Direction) » HALF PI) 
E 
drawLineSegment(g, line.Start, line.End, height, 
line.Direction, false); 


// 第 二 步 ， 绘 制 前 面 
foreach (LineSegment line in list) 
{ 
if (Math.Abs(line.Direction) <= HALF PI) 
t 
drawLineSegment (g, line.Start, line.End, height, line.Direction, 
true); 


) 
Utility.FillPolygon(g, polygon, FillColor, Transparency, 0, (int)height); 


private void drawLineSegment (Graphics g, 
ESRI.ArcGIS.ADF.Web.Geometry.Point start, 
ESRI.ArcGIS.ADF.Web.Geometry.Point end, 
double height, double direction, bool fill) 
d 
using (GraphicsPath path = new GraphicsPath()) 
t 
path.AddPolygon (new System.Drawing.Point[] ( 
new System.Drawing.Point( 
Convert.ToInt32 (start.X),Convert.ToInt32 (start.Y)), 
new System.Drawing.Point( 
Convert.ToInt32 (end.X) , Convert.ToInt32 (end.Y)), 
new System.Drawing.Point( 
Convert.ToInt32 (end.X) , Convert.ToInt32 (end. Y-height)), 
new System.Drawing.Point( 
Convert.ToInt32 (start.X),Convert.ToInt32 (start.Y-height)), 
new System.Drawing.Point( 
Convert.ToInt32 (start.X),Convert.ToInt32 (start.Y)) 


n: 


if (fill) //Fill facade 
{ 
double b = calculateBrightness (direction + HALF PI); 
Color c = adjustBrightness (FillColor, b); 
Color fillColor = Color.FromArgb( 
Utility.TransparencyToAlpha (Transparency), c); 
using (SolidBrush brush - new SolidBrush(fillColor)) 


i 
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g.FillPath(brush, path); 
brush.Dispose(); 


rn 
if (OutlineColor != Color.Transparent && OutlineColor != Color.Empty) 


t 
using (Pen pen = new Pen(OutlineColor, 0.5f)) 
{ 
g.DrawPath(pen, path); 
pen.Dispose(); 


) 
path.Dispose(); 


#endregion 
dregion 辅助 方法 


private Color adjustBrightness (Color color, double brightnessFactor) 
{ 
int r = color.R; 
int g = color-G; 
int b = color.B; 
brightnessFactor *= (1 - ambience); 
r = Convert.ToInt32(r * (1 - brightnessFactor)); 
g = Convert.ToInt32(g * (1 - brightnessFactor)); 
b = Convert.ToInt32(b * (1 - brightnessFactor)); 
if (r > 255) r= 255; 
else if tr < 0) r= 0; 
if (g > 255) g = 255; 
else if (g < 0) g= 0; 
IE (6 255) D = 2557 
else if (b < 0) b 2 0; 
return Color.FromArgb(color.A, r, g, b); 
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private const double HALF PI = Math.PI * 0.5; 

/// «summary» 

/// 根据 与 光源 的 角度 计算 亮度 系数 

/// «/summary» 

/// «returns»0 表示 垂直 ，1 表示 同方 向 或 反 向 </returns> 

Private double calculateBrightness (double angle) 

t 
double diff = (lightDirection + HALF PI - angle); 
return Math.Abs(Math.Sin(-diff / 2)); 


private static double getLineDirection( 
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ESRI.ArcGIS.ADF.Web.Geometry.Point start, 
ESRI.ArcGIS.ADF.Web.Geometry.Point end) 
t 

double dx = end.X - start.X; 


double dy = end.Y - start.Y; 
return Math.Atan2 (dy, dx); 

} 

#endregion 


在 工程 新 加 入 一 ASP.NET 页 面 ， 命 名 为 Renderer3DPage。 

在 Renderer 3DPage.aspx 页 面 中 增加 一 地 图 资源 管理 器 控件 、 一 地 图 控件 与 一 Toc 控件 。 通 过 
地 图 资源 管理 器 控件 的 MapResourcesItem 属性 设置 对 话 框 , 先 加 入 一 个 GraphicsLayer 类 型 的 资源 ， 
命名 为 GraphicsDataSource， 然 后 加 入 USAMap 地 图 资源 。 


在 Renderer3DPage 类 的 头 部 加 入 如 下 命名 空间 引用 : 


using ESRI.ArcGIS.ADF.Web.Display.Graphics; 
using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.DataSources.Graphics; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.Web.DataSources; 


然后 在 Renderer3DPage 类 中 加 入 Page 对 象 的 PreRender 事件 处 理 方法 ， 代 码 如 下 : 


protected void Page PreRender(object sender, EventArgs e) 
i 
if (IsPostBack) 
return; 


MapResourceItem resourceltem = 
MapResourceManagerl.ResourceItems.Find ("GraphicsDataSource"); 
MapResource resource = resourceltem.Resource as MapResource; 
if (resource !- null) 
{ 
if (Mapl.Extent == null) 
t 


IMapResource priResource - Mapl.PrimaryMapResourceInstance; 


FeatureGraphicsLayer layer = 
GenerateGraphicsHelper.AttributeQuery (Mapl, 50); 
addLayer (resource, layer); 
) 


Mapl.RefreshResource ("GraphicsDataSource"); 


private static void addLayer (MapResource resource, FeatureGraphicsLayer layer) 
d 

if (layer != null) 

{ 
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//Apply renderer 

SimpleRenderer3D renderer - new SimpleRenderer3D(); 
renderer.FillColor = System.Drawing.Color.White; 
renderer.HeightColumnName = "POP1999"; 
renderer.ScaleHeight = 1; 

renderer.MaxHeight = 50; 

layer.Renderer - renderer; 


if (resource.Graphics.Tables.Contains (layer.TableName)) 
resource.Graphics.Tables.Remove (layer.TableName); 
resource.Graphics.Tables.Add (layer); 


} 
编译 并 运行 程序 ， 可 得 到 如 图 7.7 所 示 的 以 三 维 形状 表示 的 要 素 ， 其 中 高 度 是 根据 人 口 的 多 少 
来 设置 的 。 从 图 中 可 以 直观 地 看 出 美国 人 口 分 布 情况 。 


Jb Untitled Page — Microsoft Internet Explorer 
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AE) http: //Localhost/CustonRender/Renderer3DP age. aspx — 


GraphicsDataSource 
USAMap 


图 7.7 自 定义 三 维 着 色 器 


7.4 ”在 GIS 服务 器 端 操作 图 形 


在 44.3 节 中 介绍 了 如 何 通过 设置 MapDescription 对 象 的 CustomGraphics 属性 ， 从 而 实现 在 
GIS 服务 器 端 高 亮 显示 选择 的 要 素 。 在 5.5.3 节 中 仅 介 绍 了 如 何 获 取 服 务 器 上 下 文 以 及 服务 器 对 象 ， 
从 而 更 细 粒 度 地 来 控制 服务 器 的 地 图 。 

在 本 节 中 我 们 将 通过 绘制 专题 图 的 实例 ， 进 一 步 介绍 如 何在 服务 器 端 操作 图 形 。 

服务 器 端 设 置 专题 图 用 到 的 主要 程序 集 是 ESRI.ArcGIS.Carto。 

在 Visual Studio 2005 中 ,利用 File 菜 单 的 New Web Site 创建 一 个 新 的 站 点 ,命名 为 ThemeMap。 

在 Defaultaspx 页 面 中 增加 一 地 图 资源 管理 器 控件 、 一 地 图 控件 与 一 Toc 控件 。 通 过 地 图 资源 
管理 器 控件 的 MapResourcesItem 属性 设置 对 话 框 ， 先 加 入 一 个 GraphicsLayer 类 型 的 资源 ， 命 名 为 
GraphicsDataSource， 然 后 加 入 USAMap 地 图 资源 。 
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通过 工程 的 右键 菜单 的 Add ArcGIS Identity 命令 ， 加 入 连接 USAMap 地 图 资源 的 身份 信息 。 
再 在 Default.aspx 页 面 中 增加 一 HTML 类 型 的 Select 控件 , 通过 直接 修改 代码 ,在 该 控件 中 加 
些 选项 与 设置 onchange 事件 的 处 理 函 数 。 代 码 如 下 : 


<select id-"Selectl" onchange-"SetTheme (this)" 
style="left: 416px; width: 152px; position: absolute; top: 331px"> 
«option value-"1" > 独立 值 专题 图 </option> 
<option value="2" > 范围 专题 图 </option> 
<option value-"3" > 柱状 专题 图 </option> 
<option value-"4" > 饼 状 专题 图 </option> 
<option value="5" > 等 级 符号 专题 图 </option> 
<option value-"6" > 点 密度 专题 图 </option> 
</select> 


在 <head> 与 </head> 之 间 加 入 SetTheme 函数 的 代码 ， 如 下 所 示 : 


现 


<script language-"javascript" type="text/javascript"> 
function SetTheme (selectCtrl) 


{ 


) 


var message = selectCtrl.value; 
var context - 'Pagel'; 
«$-setThemCallBack$» 


</script> 


上 述 代码 执行 时 调用 setThemCallBack 代表 的 回调 代码 。 
在 Default.aspx.cs 文件 中 ， 首 先 将 类 的 声明 代码 行 后 面 加 入 对 ICallbackEventHandler 接口 的 实 
然后 在 类 中 加 入 如 下 两 个 字段 : 


public string setThemCallBack; // 客户 端 函 数 的 引用 
private string callbackArg; // 回调 事件 的 结果 


在 Page Load 方法 中 加 入 如 下 代码 ， 获 取 一 个 对 客户 端 函数 的 引用 : 


protected void Page Load(object sender, EventArgs e) 


{ 


setThemCallBack = ClientScript.GetCallbackEventReference (this, 


) 


"message", "processCallbackResult", "context", "postBackError", true); 


加 入 ICallbackEventHandler 接口 要 求 的 两 个 方法 的 实现 代码 ， 如 下 所 示 : 


void ICallbackEventHandler.RaiseCallbackEvent (string eventArgument) { 
callbackArg = eventArgument; 


} 


string ICallbackEventHandler.GetCallbackResult() { 
string[] fields - new string[2]; 
fields[0] = "POP1990"; 
fields[1] = "POP1999"; 


if (callbackArg == "1") ( 


) 
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else if(callbackArg == "2") ( 
a if (callbackArg == "3") { 

ES if(callbackArg == "4") ( 
ie if (callbackArg == "5") { 
E if (callbackArg == "6") { 
) 


return ""; 


} 
通过 上 述 的 代码 ， 整 个 应 用 程序 的 框架 就 搭 好 了 ， 下 面 需要 做 的 就 是 针对 每 个 类 型 的 专题 图 ， 
编写 实现 代码 。 


7.4.1 独立 值 专题 图 


独立 值 专题 图 是 一 种 比较 简单 的 专题 地 图 。 它 使 用 不 同 的 颜色 、 符 号 或 线形 来 显示 不 同 的 数据 。 
根据 独立 值 绘制 地 图 对 象 的 专题 地 图 有 助 于 强调 数据 的 类 型 差异 而 不 是 显示 定量 信息 (如 给 定 区 域 
内 的 商店 类 型 、 分 区 类 型 等 等 ) 。 因 此 ， 当 用 户 只 需要 使 用 单一 的 数据 值 来 泻 染 时 ， 可 以 使 用 独立 
值 专题 图 。 

例如 ， 要 制作 一 个 区 域 的 土地 利用 类 型 专题 图 ， 该 区 域 可 能 的 土地 利用 类 型 有 工业 用 地 、 农 业 
用 地 和 居民 区 用 地 等 , 这 时 可 以 利用 打开 表 中 的 土地 利用 类 型 来 制作 独立 值 专题 图 , 不 同 的 利用 类 
型 赋予 不 同 的 颜色 ， 从 而 产生 简单 明了 的 土地 利用 专题 图 。 

ESRI.ArcGIS.Carto 中 的 IUniqueValueRenderer 接口 用 于 创建 独立 值 专题 图 。 

该 接口 管理 一 组 类 别 与 符号 。 数 据 中 的 唯一 值 可 用 于 定义 一 类 别 ， 用 单独 的 一 种 符号 来 表示 。 
该 数据 的 值 可 以 是 一 组 值 的 组 合 , 这样 可 以 用 一 个 符号 来 表示 不 同 的 值 。 要 实现 这 种 操作 ,需要 使 
用 AddReferenceValue 方法 与 ReferenceValue 属性 。 

在 工程 中 加 入 ASP.NET 文件 夹 App_Code， 在 其 中 新 增加 GisFunctionality 类 。 在 该 类 
中 首先 加 入 如 下 一 些 命名 空间 的 引用 : 

using ESRI.ArcGIS.Display; 

using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 

using ESRI.ArcGIS.ADF.Connection.AGS; 

using ESRI.ArcGIS.Server; 

using ESRI.ArcGIS.Carto; 

using ESRI.ArcGIS.Geodatabase; 

using ESRI.ArcGIS.ADF.Web.UI.WebControls; 

我 们 利用 名 为 CreateUniqueValueRenderer 的 静态 方法 来 实现 独立 值 专题 图 。 首 先 在 
GisFunctionality 类 中 增加 上 述 方法 的 声明 ， 代 码 如 下 : 

public static string CreateUniqueValueRenderer ( 

ESRI.ArcGIS.ADF.Web.UI.WebControls.Map map, 
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Toc toc, int layerID, string field) 
{ 
i 


在 该 方法 中 ， 参 数 map 与 toc 分 别 代表 页 面 中 的 地 图 控件 与 Toc 控件 ，layerID 是 需要 设置 专 
题 图 图 层 在 地 图 资源 中 的 位 置 序号 ， 而 field 参数 设置 的 是 使 用 哪个 字段 来 设置 独立 值 。 
在 该 方法 中 ， 首 先 需要 完成 的 就 是 从 地 图 资源 中 得 到 服务 器 上 下 文 。 代 码 如 下 : 


// 得 到 指定 名 称 的 资源 的 地 图 功能 
MapFunctionality gisfunc = map.GetFunctionality ("USAMap") 
as MapFunctionality; 
if (gisfunc == null) 
return m"; 


MapDescription mapDesc - gisfunc.MapDescription as MapDescription; 
MapResourceLocal mapResLocal = gisfunc.MapResource as MapResourceLocal; 
// 得 到 服务 器 上 下 文 对 象 
IServerContext serverContext = mapResLocal.ServerContextInfo.ServerContext; 
if (serverContext == null) 

return ="; 


接 下 来 需要 得 到 的 就 是 指定 索引 的 图 层 ， 代 码 如 下 : 


MapServer mapServer = mapResLocal.MapServer as MapServer; 
IMapServerObjects mapServerObj - mapServer as IMapServerObjects; 
string mapName = mapServer.get MapName (0); 

ILayer layer = mapServerObj.get Layer(mapName, layerID); 
IGeoFeatureLayer featureLyer - layer as IGeoFeatureLayer; 


然后 就 可 以 设置 该 图 层 的 着 色 器 对 象 了 。 需 要 先 创 建 该 着 色 器 对 象 。 创 建 代码 如 下 : 


IUniqueValueRenderer render = serverContext.CreateObject( 
"esriCarto.UniqueValueRenderer") as IUniqueValueRenderer; 


读者 应 该 注意 的 是 ， 由 于 程序 是 在 Web 端 运行 ， 因 此 不 能 用 new 操作 来 在 GIS 服务 器 上 创建 
对 象 ， 这 样 创建 的 对 象 仍然 是 本 地 对 象 ， 而 非 服务 器 对 象 。 因 此 需要 调用 服务 器 上 下 文 对 象 的 
CreateObject 方法 来 创建 。 

专题 图 创建 的 大 部 分 工作 , 就 是 设置 着 色 器 对 象 的 属性 。 通过 如 下 代码 设置 着 色 器 的 一 般 与 默 
认 属 性 值 : 

ISimpleFillSymbol symbol = serverContext.CreateObject( 

"esriDisplay.SimpleFillSymbol") as SimpleFillSymbol; 

symbol.Color = GetRGB(serverContext, 239, 228, 249); 

symbol.Outline.Width = 0.4; 

render.FieldCount - 1; 

render.set Field(0, field); 

render.DefaultSymbol = symbol as ISymbol; 


下 面 要 实现 的 就 是 针对 指定 字段 中 不 同 的 值 设 置 单独 的 不 同 的 符号 。 因 此 需要 对 图 层 中 的 属性 
进行 循环 ， 可 以 通过 游标 对 象 来 进行 循环 。 加 入 如 下 代码 ， 得 到 循环 游标 : 


ICursor pCursor = featureLyer.Search(null, true) as ICursor; 
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IRow row = pCursor.NextRow(); 

上 述 代码 通过 游标 对 象 的 NextRow 方法 ， 将 游标 位 置 指向 图 层 中 的 第 一 条 记录 。 

由 于 传 入 的 参数 指明 的 是 字段 名 称 , 而 通过 获取 游标 只 能 用 字段 索引 得 到 字段 的 值 。 因 此 需要 
在 循环 之 前 ， 得 到 字段 的 索引 。 代 码 如 下 : 


int fieldIndex = 0; 
for (int j = 0; j < row.Fields.FieldCount; j++) ( 


) 


string fieldName = row.Fields.get Field(j).Name.ToUpperInvariant(); 
if (fieldName -- field) ( 

fieldIndex - j; 

break; 


下 面 就 可 以 循环 设置 着 色 器 对 象 的 Value 属性 了 。 循 环 代码 如 下 : 


Random ranColor = new Random(); 
// 循环 设置 每 个 值 的 符号 


while (row != null) ( 


) 


string fieldValue - row.get Value(fieldIndex).ToString(); 


// 先 判断 该 值 是 否 已 经 存在 于 着 色 器 中 
bool hasFound = false; 
for (int i = 0; i < render.ValueCount; i++) ( 


if (render.get Value(i) -- fieldValue) ( 
hasFound - true; 
break; 


) 


// 只 加 入 没有 存在 的 
if (hasFound == false) ( 
IFillSymbol fillSymbol = 
serverContext.CreateObject ("esriDisplay.SimpleFillSymbol") 
as IFillSymbol; 
fillSymbol.Color - 
GetRGB(serverContext, ranColor.Next (255), 
ranColor.Next(255), ranColor.Next (255)); 
render.AddValue(fieldValue, "Name", fillSymbol as ISymbol); 
render.set Label(fieldValue, fieldValue); 
render.set Symbol(fieldValue, fillSymbol as ISymbol); 
) 


row = pCursor.NextRow(); 


在 上 面 的 循环 中 , 由 于 需要 设置 的 不 同 的 值 才 设置 不 同 的 符号 , 因此 需要 先 判断 本 记录 该 字段 
的 值 已 经 加 入 到 着 色 器 中 了 。 只 有 没有 加 入 着 色 器 的 值 ， 才 需要 设置 一 个 新 的 序号 。 

在 设置 着 色 器 符号 与 注 记 的 代码 中 , 利用 GetRGB 方法 从 随机 的 颜色 值 中 得 到 填充 符号 对 象 的 
颜色 ， 然 后 利用 着 色 器 对 象 的 AddValue 方法 ， 新 增加 独立 值 符号 ， 用 set Label 方法 设置 注 记 。 
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最 后 要 实现 的 是 将 着 色 器 应 用 到 图 层 对 象 上 ， 并 刷新 地 图 与 Toc。 代 码 如 下 : 
// 应 用 专题 到 指定 图 层 


featureLyer.Renderer = render as IFeatureRenderer; 
// 释放 服务 器 上 下 文 对 象 


serverContext.ReleaseContext (); 


// 刷新 地 图 及 Toc 

toc.Refresh(); 

CallbackResult tocCallbackResult = RefreshControlHtml (toc); 
map.CallbackResults.Add (tocCallbackResult); 

map.Refresh(); 

return map.CallbackResults.ToString(); 


在 上 述 代 码 中 用 到 了 GetRGB 5j RefreshControlHtml 两 个 辅助 方法 ， 它 们 的 代码 如 下 : 


private static IColor GetRGB( 

IServerContext serverContext, int red, int green, int blue) ( 
IRgbColor rgbColor = serverContext.CreateObject( 

"esriDisplay.RGBColor") as IRgbColor; 

IColor color - rgbColor as IColor; 
rgbColor.Red - red; 
rgbColor.Green - green; 
rgbColor.Blue - blue; 
return color; 


private static CallbackResult RefreshControlHtml(Control control) ( 
System.IO.StringWriter stringWriter = new System.IO.StringWriter(); 
HtmlTextWriter writer = new HtmlTextWriter(stringWriter); 
control.RenderControl (writer); 
string htmlContent = stringWriter.ToString():; 
stringWriter.Close(); 
return new CallbackResult (control, "content", htmlContent); 


) 
切换 到 Default.aspx.cs 文件 中 ， 找 到 GetCallbackResult 方法 ， 在 callbackArg 为 1 的 部 分 ， 加 
入 对 CreateUniqueValueRenderer 方法 的 调用 。 代 码 如 下 : 


return GisFunctionality.CreateUniqueValueRenderer (Mapl, Tocl, 1, 
"STATE NAME"); 


上 述 代码 表示 ， 针 对 USAMap 地 图 资源 中 的 第 二 个 图 层 〈 即 美国 州 行政 区 划 ) 的 州 名 设置 独 
立 值 专题 图 ， 即 每 个 州 使 用 一 个 不 同 符号 显示 。 
编译 并 运行 程序 ， 程 序 运行 效果 如 图 7.8 所 示 。 
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图 7.8 独立 值 专题 图 


7.4.0 ”范围 专题 图 


范围 专题 图 是 按照 设置 的 范围 显示 数据 , 这 些 范 围 用 颜色 和 图 案 进 行 泻 染 。 范 围 专 题 图 能 够 通 
过 点 、 线 和 区 域 来 说 明 数 值 ， 在 反映 数值 和 地 理 区 域 的 关系 〈 如 销售 数字 、 家 庭 收 入 ) ， 或 显示 比 
率 信息 如 人 口 密 度 〈 人 口 除 以 面积 ) 时 很 有 用 。 

实现 范围 专 地 图 最 重要 的 工作 就 是 进行 范围 的 划分 。ArcGIS 使 用 5 个 范围 划分 方法 自动 创建 
范围 专题 图 , 它们 分 别 是 等 计数 (Equal Count) 、 等 范围 (Equal Ranges) . 自然 划分 (Natural Break) 、 
标准 差 (Standard Deviation) 和 分 位 数 (Quantile) 。 

我 们 利用 名 为 GreateClassBreaksRender 的 静态 方法 来 实现 范围 专题 图 ,首先 在 GisFunctionality 
类 中 增加 上 述 方法 的 声明 ， 代 码 如 下 : 

public static string CreateClassBreaksRenderer( 

ESRI.ArcGIS.ADF.Web.UI.WebControls.Map map,Toc toc, int layerID, 


string field, int classCount) { 


) 

在 该 方法 中 ， 参 数 map 与 toc 分 别 代表 页 面 中 的 地 图 控件 与 Toc 控件 ，layerID 是 需要 设置 专 
题 图 图 层 在 地 图 资源 中 的 位 置 序号 ， 而 field 参数 设置 的 是 使 用 哪个 字段 来 统计 。 

在 该 方法 中 ,首先 需要 完成 的 就 是 从 地 图 资源 中 得 到 服务 器 上 下 文 ， 并 从 中 得 到 图 层 对 象 。 代 
码 如 下 : 


MapFunctionality gisfunc = map.GetFunctionality ("USAMap") 
as MapFunctionality; 


if (gisfunc -- null) 
return ""; 
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MapDescription mapDesc = gisfunc.MapDescription as MapDescription; 
MapResourceLocal mapResLocal = gisfunc.MapResource as MapResourceLocal; 
IServerContext serverContext = mapResLocal.ServerContextInfo.ServerContext; 
if (serverContext == null) 

return ^"; 


MapServer mapServer = mapResLocal.MapServer as MapServer; 
IMapServerObjects mapServerObj = mapServer as IMapServerObjects; 
string mapName = mapServer.get MapName (0); 

ILayer layer = mapServerObj.get Layer(mapName, layerID); 
IGeoFeatureLayer featureLyer = layer as IGeoFeatureLayer; 


对 于 范围 专题 图 ， 由 于 需要 对 数据 进行 划分 ,那么 首先 需要 对 这 些 数据 进行 统计 。 加 入 如 下 代 


码 


IBasicHistogram pBasicHist = null; 

pBasicHist = serverContext.CreateObject ("esriCarto.BasicTableHistogram") 
as IBasicHistogram; 

ITableHistogram pTableHist = pBasicHist as ITableHistogram; 

pTableHist.Field field; 

pTableHist.Table = featureLyer.FeatureClass as ITable; 

object xVals = null; 

object frqs; 

pBasicHist.GetHistogram(out xVals, out frqs); 


上 面 的 代码 ， 对 feld 指定 的 字段 中 的 值 进 行 统计 ， 不 同 的 值 记录 在 xVals 变量 中 ， 每 个 值 对 
应 的 个 数 记 录 在 frqs 中 。 

下 来 要 完成 的 是 针对 这 些 统计 数据 ， 进 行 指 定 方法 的 划分 ， 我 们 这 里 使 用 分 位 数 的 方式 划分 。 
代码 如 下 : 


IClassifyGEN quantile = serverContext.CreateObject ("esriSystem.Quantile") 
as IClassifyGEN; 

quantile.Classify(xVals, frqs, ref classCount); 

System.Double[] classBreaks - quantile.ClassBreaks as System.Double[]; 


通过 上 述 代码 后 ， 数 据 分 类 放 在 classBreaks 数组 中 了 。 
下 面 通过 一 个 算法 自动 根据 这 些 数据 以 及 起 始 颜 色 与 终止 颜色 , 自动 插入 其 他 颜色 的 值 。 代 码 
如 下 : 


IAlgorithmicColorRamp colorRamp = null; 

colorRamp = serverContext.CreateObject ("esriDisplay.AlgorithmicColorRamp") 
as IAlgorithmicColorRamp; 

colorRamp.Algorithm = esriColorRampAlgorithm.esriCIELabAlgorithm; 
colorRamp.FromColor = GetRGB(serverContext, 255, 210, 210); 
colorRamp.ToColor = GetRGB(serverContext, 190, 0, 170); 

colorRamp.Size = classCount; 

bool ok = true; 


colorRamp.CreateRamp (out ok); 


下 面 就 可 以 创建 着 色 器 对 象 了 。 代 码 如 下 : 
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IClassBreaksRenderer render - null; 

render = serverContext.CreateObject ("esriCarto.ClassBreaksRenderer") 
as IClassBreaksRenderer; 

render.Field - field; 

render.BreakCount = classCount; 

render.MinimumBreak = classBreaks[0]; 


IEnumColors pEnumColors = colorRamp.Colors; 

for (int i = 0; i < classCount; i+) ( 
render.set Break(i, classBreaks[i * 11); 
render.set Label(i, classBreaks[i] + "--" + classBreaks[i + 1]); 
IFillSymbol fillSymbol - 


serverContext.CreateObject ("esriDisplay.SimpleFillSymbol") 


as IFillSymbol; 
fillSymbol.Color = pEnumColors.Next(); 
render.set Symbol(i, fillSymbol as ISymbol); 
) 


最 后 需要 加 入 的 代码 是 将 着 色 器 应 用 到 图 层 上 ， 并 刷新 地 图 与 Toc。 代 码 如 下 : 
// 应 用 专题 到 指定 图 层 


featureLyer.Renderer = render as IFeatureRenderer; 


// 释放 服务 器 上 下 文 对 象 


serverContext.ReleaseContext (); 


// 刷新 地 图 及 Toc 

toc.Refresh(); 

CallbackResult tocCallbackResult = RefreshControlHtml (toc); 
map.CallbackResults.Add (tocCallbackResult); 

map.Refresh(); 

return map.CallbackResults.ToString(); 


切换 到 Defaultaspx.cs 文件 中 ， 找 到 GetCallbackResult 方法 ， 在 callbackArg 为 2 的 部 分 ， 加 


入 对 CreateUniqueValueRenderer 方法 的 调用 。 代 码 如 下 : 


return GisFunctionality.CreateClassBreaksRenderer (Map1，Toc1，1，"POP1999" , 


"i 


上 述 代码 表示 ， 针 对 USAMap 地 图 资源 中 的 第 二 个 图 层 〈 即 美国 州 行政 区 划 )》 的 各 州 1999 4 
值 专题 图 ， 划 分 为 5 类 。 
编译 并 运行 程序 ， 程 序 运行 效果 如 图 7.9 所 示 。 


H 
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图 7.9 范围 专题 图 
7.44.8 ”柱状 专题 图 


柱状 专题 图 是 将 表 中 每 条 记录 的 专题 变量 显示 为 一 个 柱状 图 。 使 用 柱状 图 可 分 析 地 图 中 每 条 记 
录 的 多 个 变量 。 比 较 每 个 柱状 图 中 各 直方 条 的 大 小 可 考察 表 中 某 条 记录 , 而 比较 所 有 柱状 图 中 某 一 
条 直方 的 大 小 可 考察 所 有 记录 的 某 个 变量 , 比较 各 柱状 图 的 高 度 则 可 考察 整 张 表 。 用 柱状 图 来 表达 
负 值 时 ， 该 条 会 沿 柱状 图 反方 向 伸展 。 在 又 加 柱状 图 中 不 显示 负 值 。 

例如 , 要 创建 一 个 关于 人 均 收 入 的 柱状 专题 图 , 假设 有 一 张 中 国 各 个 省 份 的 表 , 其 中 包括 1985 
年 和 1995 年 的 人 均 收 入 , 通过 在 每 个 省 显示 具有 两 个 直方 条 的 统计 图 , 一 个 代表 1985 年 的 人 均 收 
入 ， 一 个 代表 1995 年 的 人 均 收 入 。 可 以 比较 1985 年 和 1995 年 每 个 省 的 人 均 收 入 增长 情况 ， 也 可 
以 分 析 几 个 不 同 省 之 间 人 均 收 入 或 人 均 收 入 的 增长 情况 。 

注意 , 虽然 柱状 图 可 以 表示 多 个 变量 , 但 是 为 了 得 到 最 佳 显 示 效果 ， 在 分 析 中 每 个 柱状 图 最 好 
不 要 超过 6 个 直方 条 。 

利用 名 为 CreateBarRenderer 的 静态 方法 来 实现 柱状 专题 图 。 首 先 在 GisFunctionality 类 
中 增加 上 述 方法 的 声明 ， 代 码 如 下 : 

public static string CreateBarRenderer ( 

ESRI.ArcGIS.ADF.Web.UI.WebControls.Map map,Toc toc, int layerID, 

string[] fields) 

{ 

} 

同样 ， 在 该 方法 中 ， 参 数 map 与 toc 分 别 代 表 页 面 中 的 地 图 控件 与 Toc 控件 ，layerID 是 需要 
设置 专题 图 图 层 在 地 图 资源 中 的 位 置 序 号 ， 而 fields 参数 设置 的 是 使 用 哪些 字段 来 统计 。 

在 该 方法 中 ， 完 成 从 地 图 资源 中 得 到 服务 器 上 下 文 ， 并 从 中 得 到 图 层 对 象 。 代 码 如 下 : 
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MapFunctionality gisfunc - map.GetFunctionality ("USAMap") as 
MapFunctionality; 
if (gisfunc -- null) 
return ""; 


MapDescription mapDesc - gisfunc.MapDescription as MapDescription; 
MapResourceLocal mapResLocal = gisfunc.MapResource as MapResourceLocal; 
IServerContext serverContext = mapResLocal.ServerContextInfo.ServerContext; 
if (serverContext == null) 

return ""; 


MapServer mapServer = mapResLocal.MapServer as MapServer; 
IMapServerObjects mapServerObj = mapServer as IMapServerObjects; 
string mapName = mapServer.get MapName (0); 

ILayer layer = mapServerObj.get Layer(mapName, layerID); 
IGeoFeatureLayer featureLyer = layer as IGeoFeatureLayer; 


接着 设置 专题 图 元 素 的 属性 名 称 列表 ， 代 码 如 下 


IChartRenderer chartRender = null; 

chartRender - serverContext.CreateObject ("esriCarto.ChartRenderer") 
as IChartRenderer; 

IRendererFields renderFields = chartRender as IRendererFields; 

foreach (string var in fields) 

{ 


renderFields.AddField(var, var); 
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} 
接着 实例 化 图 表 对 象 并 取得 元 素 指定 属性 的 最 大 值 ， 代 码 如 下 : 


IBarChartSymbol barChartSymbol = null; 

barChartSymbol = serverContext.CreateObject ("esriDisplay.BarChartSymbol") 
as IBarChartSymbol; 

IChartSymbol chartSymbol = barChartSymbol as IChartSymbol; 

chartSymbol.MaxValue - GetStaMaxMin(featureLyer, fields)[0]; 

barChartSymbol.Width 8; 

IMarkerSymbol markerSymbol = barChartSymbol as IMarkerSymbol; 

markerSymbol.Size = 50; 


接着 加 入 设置 柱状 图 每 列 填充 效果 的 代码 ， 如 下 所 示 


ISymbolArray symbolArray = barChartSymbol as ISymbolArray; 
Random ranColor = new Random(); 

for (int i= 0; i < fields.Length; i++) 

t 


IFillSymbol fillSymbol — 
serverContext.CreateObject ("esriDisplay.SimpleFillSymbol") 
as IFillSymbol; 
fillSymbol.Color = GetRGB(serverContext, ranColor.Next (255), 
ranColor.Next(255), ranColor.Next (255)); 
symbolArray.AddSymbol ((ISymbol)fillSymbol); 
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然后 设置 图 层 背景 ， 代 码 如 下 : 


ISimpleFillSymbol symbol = 
serverContext.CreateObject ("esriDisplay.SimpleFillSymbol") 
as SimpleFillSymbol; 
symbol.Color = GetRGB(serverContext, 239, 228, 249); 
chartRender.BaseSymbol = symbol as ISymbol; 


并 将 柱状 专题 应 用 到 指定 图 层 ， 代 码 如 下 : 


chartRender.ChartSymbol = barChartSymbol as IChartSymbol; 
chartRender.Label = "Test"; 

chartRender.UseOverposter - false; 
chartRender.CreateLegend(); 

featureLyer.Renderer - chartRender as IFeatureRenderer; 


最 后 释放 服务 器 上 下 文 对 象 ， 并 刷新 地 图 与 Toc。 代 码 如 下 : 


serverContext.ReleaseContext () 7 

map.Refresh(); 

toc.Refresh(); 

CallbackResult tocCallbackResult = RefreshControlHtml (toc); 
map.CallbackResults.Add (tocCallbackResult); 

return map.CallbackResults.ToString(); 


上 述 代码 利用 GetStaMaxMin 方法 来 得 到 某 图 层 中 某 字 段 的 最 大 值 与 最 小 值 。 代 码 如 下 : 


private static double[] GetStaMaxMin (IGeoFeatureLayer featureLyer, 
string[] fields) { 
double pMaxValue = 0; 
double pMinValue 0; 
double pStaMax; 
double pStaMin; 
double[] PMaxMin = new double[2]; 
for (int i = 0; i < fields.Length; i++) ( 
ICursor pCursor - featureLyer.Search(null, true) as ICursor; 
IDataStatistics pDataSta = new DataStatisticsClass(); 
pDataSta.Cursor - pCursor; 
pDataSta.Field = fields[i]; 
pStaMax - pDataSta.Statistics.Maximum; 
pStaMin - pDataSta.Statistics.Minimum; 
if (pMaxValue < pStaMax) { 
pMaxValue = pStaMax; 


) 
if (pMinValue > pStaMin) { 
pMinValue - pStaMin; 


) 

PMaxMin[0] pMaxValue; 
PMaxMin[1] = pMinValue; 
return PMaxMin; 
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切换 到 Default.aspx.cs 文件 中 ， 找 到 GetCallbackResult 方法 ， 在 callbackArg 为 3 的 部 分 ， 加 
入 对 CreateUniqueValueRenderer 方法 的 调用 。 代 码 如 下 : 


return GisFunctionality.CreateBarRenderer (Mapl, Tocl, 1, fields); 

上 述 代码 表示 ， 针 对 USAMap 地 图 资源 中 的 第 二 个 图 层 〈 即 美国 州 行政 区 划 ) 的 各 州 1990 年 
与 1999 年 人 口 数 据 设 置 柱状 专题 图 。 

编译 并 运行 程序 ， 程 序 运 行 效果 如 图 7.10 所 示 。 
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图 7.10 柱状 专题 图 
7.4.4” 饼 状 专题 图 


也 可 以 以 饼 图 显示 表 中 各 记录 的 专题 变量 。 在 地 图 上 使 用 饼 图 同样 可 一 次 分 析 多 个 变量 , 比较 
每 个 图 中 饼 扇 的 大 小 可 考察 表 中 某 条 记录 , 比较 所 有 人 饼 图 中 某 一 个 饼 扇 , 可 考察 所 有 记录 中 某 个 变 
量 的 变化 ， 比 较 各 饼 图 的 直径 则 可 考察 整 张 表 。 

人 饼 图 与 柱状 图 类 似 ， 饼 图 允许 每 次 对 记录 分 析 多 个 变量 ,但 柱状 图 比较 的 是 直方 条 的 高 度 ， 而 
人 饼 图 比较 的 饼 中 的 饼 扇 ， 或 是 对 所 有 人 饼 分 析 某 个 特定 的 饼 肩 。 

饼 图 与 柱状 图 对 于 分 析 人 口 统计 数据 都 是 非常 有 用 的 。 例 如 ， 假 设 有 中 国人 口 统计 信息 表 ， 
表 中 包含 了 各 个 省 的 人 口 总 数 以 及 几 个 主要 人 口 群体 ( 男 、 女 、 城 市 人 口 及 农村 人 口 等 ) 组 成 。 通 
过 创建 饼 图 专题 图 , 可 以 显示 每 个 人 口 群体 的 人 数 及 其 在 每 个 饼 中 所 占 的 份额 , 这 样 就 可 以 查看 不 
同 省 的 人 口 总 数 及 其 人 口 群体 是 如 何 变 化 的 。 与 创建 柱状 图 一 样 ,为 获取 最 佳 效 果 ， 在 分 析 时 每 张 
饼 图 最 好 不 要 超过 6 个 饼 扇 。 

我 们 利用 名 为 CreateBarRenderer 的 静态 方法 来 实现 饼 状 专题 图 。 首 先 在 GisFunctionality 类 中 
增加 上 述 方法 的 声明 ， 代 码 如 下 : 

public static string CreateBarRenderer ( 

ESRI.ArcGIS.ADF.Web.UI.WebControls.Map map,Toc toc, int layerID, 
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string[] fields) 
{ 
} 


参数 map 与 toc 分 别 代 表 页 面 中 的 地 图 控件 与 Toc 控件 ，layerID 是 需要 设置 专题 图 图 层 在 地 
图 资源 中 的 位 置 序号 ， 而 fields 参数 设置 的 是 使 用 哪些 字段 来 统计 。 

完成 从 地 图 资源 中 得 到 服务 器 上 下 文 ， 并 从 中 得 到 图 层 对 象 。 代 码 如 下 : 

MapFunctionality gisfunc = map.GetFunctionality ("USAMap") 

as MapFunctionality; 


if (gisfunc == null) 
return " 


MapDescription mapDesc - gisfunc.MapDescription as MapDescription; 
MapResourceLocal mapResLocal = gisfunc.MapResource as MapResourceLocal; 
IServerContext serverContext = mapResLocal.ServerContextInfo.ServerContext; 
if (serverContext == null) 

return ""; 


MapServer mapServer = mapResLocal.MapServer as MapServer; 
IMapServerObjects mapServerObj = mapServer as IMapServerObjects; 
string mapName = mapServer.get MapName (0); 

ILayer layer = mapServerObj.get Layer(mapName, layerID); 
IGeoFeatureLayer featureLyer - layer as IGeoFeatureLayer; 


接着 设置 专题 图 元 素 的 属性 名 称 列表 ， 代 码 如 下 : 


IChartRenderer chartRender = null; 
chartRender - serverContext.CreateObject ("esriCarto.ChartRenderer") 
as IChartRenderer; 
IRendererFields renderFields = chartRender as IRendererFields; 
foreach (string var in fields) 
t 
renderFields.AddField(var, var); 


) 
接着 实例 化 图 表 对 象 并 取得 元 素 指定 属性 的 最 大 值 ， 代 码 如 下 : 


IPieChartSymbol pieChartSymbol = null; 

pieChartSymbol = serverContext.CreateObject ("esriDisplay.PieChartSymbol") 
as IPieChartSymbol; 

IChartSymbol chartSymbol = pieChartSymbol as IChartSymbol; 

pieChartSymbol.Clockwise = true; 

pieChartSymbol.UseOutline - true; 

chartSymbol.MaxValue = GetStaMaxMin(featureLyer, fields)[0]; 


设置 饼 图 外 围 线 的 代码 如 下 : 


ISimpleLineSymbol outLine = null; 

outLine = serverContext.CreateObject ("esriDisplay.SimpleLineSymbol") 
as ISimpleLineSymbol; 

outLine.Color = GetRGB(serverContext, 255, 0, 255); 
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outLine.Style = esriSimpleLineStyle.esriSLSSolid; 
outLine.Width E 

pieChartSymbol.Outline = outLine; 

IMarkerSymbol markerSymbol = pieChartSymbol as IMarkerSymbol; 
markerSymbol.Size = 25; 


设置 饼 状 图 外 围 填充 效果 代码 如 下 : 


ISymbolArray symbolArray = pieChartSymbol as ISymbolArray; 

ISimpleFillSymbol symbol = null; 

symbol = serverContext.CreateObject ("esriDisplay.SimpleFillSymbol") 
as SimpleFillSymbol; 

symbol.Color = GetRGB(serverContext, 213, 212, 252); 

symbol.Outline - outLine; 


通过 循环 ， 设 置 饼 状 图 每 列 填 充 效果 。 代 码 如 下 : 


Random ranColor = new Random(); 
for (inti = 0; i < fields.Length; i++) 
{ 


IFillSymbol fillSymbol = 
serverContext.CreateObject ("esriDisplay.SimpleFillSymbol") 
as IFillSymbol; 
fillSymbol.Color = GetRGB(serverContext, ranColor.Next (255), 
ranColor.Next(255), ranColor.Next (255)); 
symbolArray.AddSymbol((ISymbol)fillSymbol); 
) 


接着 设置 地 图 图 层 背 景 ， 代 码 如 下 : 


symbol = serverContext.CreateObject ("esriDisplay.SimpleFillSymbol") 
as SimpleFillSymbol; 

symbol.Color = GetRGB(serverContext, 239, 228, 249); 

chartRender.BaseSymbol - symbol as ISymbol; 


然后 设置 饼 状 图 表 属 性 ， 代 码 如 下 : 


IPieChartRenderer pieChartRenderer = chartRender as IPieChartRenderer; 
pieChartRenderer.MinValue = 453588; 

pieChartRenderer.MinSize = 10; 

pieChartRenderer.FlanneryCompensation = false; 
pieChartRenderer.ProportionalBySum - true; 
pieChartRenderer.ProportionalField fields[0]; 
chartRender.ChartSymbol = pieChartSymbol as IChartSymbol; 
chartRender.Label = "Population"; 


最 后 将 饼 状 专题 应 用 到 指定 图 层 ， 并 刷新 地 图 与 Toc。 代 码 如 下 : 


chartRender.UseOverposter = false; 
chartRender.CreateLegend(); 

featureLyer.Renderer - chartRender as IFeatureRenderer; 
// 释放 服务 器 上 下 文 对 象 

serverContext.ReleaseContext (); 

toc.Refresh(); 
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CallbackResult tocCallbackResult = RefreshControlHtml (toc); 
map.CallbackResults.Add (tocCallbackResult); 

map.Refresh(); 

return map.CallbackResults.ToString(); 


切换 到 Defaultaspx.es 文件 中 ， 找 到 GetCallbackResult 方法 ， 在 callbackArg 为 4 的 部 分 ， 加 
入 对 CreateUniqueValueRenderer 方法 的 调用 。 代 码 如 下 : 


return GisFunctionality.CreatePieRenderer(Mapl, Tocl, 1, fields); 


上 述 代码 表示 ， 针 对 USAMap 地 图 资源 中 的 第 二 个 图 层 〈 即 美国 州 行政 区 划 ) 的 各 州 1990 年 
与 1999 年 人 口 数据 设置 饼 图 专题 图 。 
编译 并 运行 程序 ， 程 序 运行 效果 如 图 7.11 所 示 。 
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图 7.11 饼 图 专题 图 


7.4.5 等 级 符号 专题 图 


等 级 符号 专题 图 为 表 中 每 条 记录 显示 一 个 符号 , 符号 大 小 与 数据 值 成 比例 。 等 级 符号 专题 图 用 
特定 的 数值 来 显示 数据 ， 对 于 阐明 定量 信息 (如 由 高 到 低 依 次 变化 ) 很 有 用 处 。 符 号 的 大 小 与 该 要 
素 每 字段 对 应 的 数值 成 比例 ， 数 值 越 大 符号 就 越 大 ， 数 值 越 小 符号 就 越 小 。 因此， 等 级 符号 最 适合 
数据 值 数据 。 例 如 使 用 等 级 符号 图 来 显示 不 同 区 域 的 年 销售 额 ， 或 不 同 地 区 的 人 口 数 量 等 。 

在 ArcGISObjects 中 IProportionalSymbolRenderer 接口 可 用 于 创建 等 级 符号 专题 图 。 

我 们 利用 名 为 CreatePraportionalRenderer 的 静态 方法 来 实现 等 级 符号 专题 图 。 首 先 在 
GisFunctionality 类 中 增加 上 述 方法 的 声明 ， 代 码 如 下 : 

public static string CreateProportionalRenderer( 

ESRI.ArcGIS.ADF.Web.UI.WebControls.Map map, Toc toc, int layerID, string field) 


1 
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从 地 图 资源 中 得 到 服务 器 上 下 文 ， 并 从 中 得 到 图 层 对 象 。 代 码 如 下 : 


MapFunctionality gisfunc = 
map.GetFunctionality("USAMap") as MapFunctionality; 
if (gisfunc == null) 
return ""; 


MapDescription mapDesc - gisfunc.MapDescription as MapDescription; 
MapResourceLocal mapResLocal = gisfunc.MapResource as MapResourceLocal; 
IServerContext serverContext = mapResLocal.ServerContextInfo.ServerContext; 
if (serverContext —- null) 

return ""; 


MapServer mapServer = mapResLocal.MapServer as MapServer; 
IMapServerObjects mapServerObj = mapServer as IMapServerObjects; 
string mapName = mapServer.get MapName (0); 

ILayer layer = mapServerObj.get Layer(mapName, layerID); 
IGeoFeatureLayer featureLyer - layer as IGeoFeatureLayer; 


接着 设置 创建 一 填充 符号 ， 用 于 设置 图 层 的 背景 ， 代 码 如 下 : 


ISimpleFillSymbol symbol = 
serverContext.CreateObject ("esriDisplay.SimpleFillSymbol") as SimpleFillSymbol; 
symbol.Color = GetRGB(serverContext, 239, 228, 249); 


接着 创建 一 简单 的 标志 符号 ,用 于 设置 图 层 中 指定 字段 最 小 值 的 符号 的 大 小 与 样式 代码 如 下 : 


ISimpleMarkerSymbol markSymbol = null; 

markSymbol = serverContext.CreateObject ("esriDisplay.SimpleMarkerSymbol" 
as ISimpleMarkerSymbol; 

markSymbol.Color = GetRGB(serverContext, 190, 0, 170); 

markSymbol.Style = esriSimpleMarkerStyle.esriSMSCircle; 

markSymbol.Outline - false; 

markSymbol.Size = 2.0; 


需要 对 数据 进行 统计 ， 得 到 最 大 值 与 最 小 值 。 统 计 代码 如 下 : 


ICursor pCursor = featureLyer.Search(null, true) as ICursor; 
IDataStatistics pDataSta = new DataStatisticsClass(); 
pDataSta.Cursor - pCursor; 

pDataSta.Field = field; 


然后 创建 一 等 级 符号 着 色 器 对 象 ， 设 置 其 Field. ValueUnit, MaxDataValue 以 及 MinDataValue 
等 属性 。 代 码 如 下 : 


IProportionalSymbolRenderer render = null; 

render - serverContext.CreateObject ("esriCarto.ProportionalSymbolRenderer") 
as IProportionalSymbolRenderer; 

render.ValueUnit = esriUnits.esriUnknownUnits; 

render.Field = field; 

render.FlanneryCompensation - true; 

render.LegendSymbolCount - 4; 

render.MaxDataValue = pDataSta.Statistics.Maximum; 
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render.MinDataValue = pDataSta.Statistics.Minimum; 
render.BackgroundSymbol = symbol; 

render.MinSymbol = markSymbol as ISymbol; 
render.CreateLegendSymbols(); 


接着 将 着 色 器 应 用 到 指定 图 层 ， 并 释放 服务 器 上 下 文 对 象 。 代 码 如 下 : 


featureLyer.Renderer = render as IFeatureRenderer; 
serverContext.ReleaseContext (); 


最 后 刷新 地 图 及 Toc。 代 码 如 下 : 


toc.Refresh(); 

CallbackResult tocCallbackResult = RefreshControlHtml (toc); 
map.CallbackResults.Add (tocCallbackResult); 

map.Refresh(); 

return map.CallbackResults.ToString(); 


切换 到 Defaultaspx.cs 文件 中 ， 找 到 GetCallbackResult 方法 ， 在 callbackArg 为 5 的 部 分 ， 加 
入 对 GisFunctionality 方法 的 调用 。 代 码 如 下 : 

return GisFunctionality.CreateProportionalRenderer (Mapl, Tocl, 1, "POP1999"); 

上 述 代码 表示 ， 针 对 USAMap 地 图 资源 中 的 第 二 个 图 层 〈 即 美国 州 行政 区 划 ) 的 各 州 1999 年 
人 口 数 据 设 置 等 级 符号 专题 图 。 

编译 并 运行 程序 ， 程 序 运行 效果 如 图 7.12 所 示 。 
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图 7.12 等 级 符号 专题 图 
7.4.6 点 密度 专题 图 


点 密度 专题 图 则 是 在 地 图 上 用 点 来 显示 数据 , 每 一 点 都 代表 一 定数 量 , 某 区域 中 点 的 总 数 与 该 
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区 域 数 值 成 比例 。 每 个 点 代表 一 定数 量 的 单元 , 该 数 乘 以 区 域内 总 的 点 数 , 就 等 于 该 区 域 的 数据 值 。 
例如 创建 一 个 人 口 密度 专题 图 , 若 某 区 域 人 口 有 20000 A, 而 每 个 点 代表 100 人 ， 则 该 区 域内 将 有 
200 个 点 。 

当 要 求 在 地 图 上 显示 一 些 原始 数据 ， 如 人 口 数 量 、 年 销售 额 、 犯 罪 率 或 者 出 生 率 等 ， 点 密度 专 
题 图 十 分 有 用 。 因 此 点 密度 专题 图 有 着 广泛 的 用 途 。 

在 ArcGISObjects 中 IDotDensityRenderer 接口 可 用 于 创建 等 级 符号 专题 图 。 

我 们 利用 名 为 CreateDotDensityRenderer 的 静态 方法 来 实现 点 密度 专题 图 。 首 先 在 
GisFunctionality 类 中 增加 上 述 方法 的 声明 ， 代 码 如 下 : 


public static string CreateDotDensityRenderer ( 
ESRI.ArcGIS.ADF.Web.UI.WebControls.Map map, Toc toc, int layerID, string field) 


t 

} 

首先 需要 完成 的 还 是 从 地 图 资源 中 得 到 服务 器 上 下 文 , 并 从 中 得 到 图 层 对 象 。 代码 同 前 几 个 小 
节 ， 这 里 不 再 重复 。 

接着 设置 创建 一 点 密度 填充 符号 ， 用 于 设置 着 色 器 的 符号 ， 代 码 如 下 

IDotDensityFillSymbol symbol = 
serverContext.CreateObject ("esriDisplay.DotDensityFillSymbol") as 
IDotDensityFillSymbol; 


symbol.BackgroundColor - GetRGB(serverContext, 239, 228, 249); 
symbol.DotSize = 3; 


上 述 只 设置 了 点 密度 填充 符号 的 大 小 , 以 及 背景 颜色 。 还 需要 另外 创建 一 个 简单 标志 符号 来 设 
置 点 的 符号 。 代 码 如 下 : 


ISymbolArray symbolArray = symbol as ISymbolArray; 

ISimpleMarkerSymbol markSymbol = null; 

markSymbol = serverContext.CreateObject ("esriDisplay.SimpleMarkerSymbol" 
as ISimpleMarkerSymbol; 

markSymbol.Color = GetRGB(serverContext, 190, 0, 170); 

markSymbol.Style = esriSimpleMarkerStyle.esriSMSCircle; 

markSymbol.Outline = false; 

markSymbol.Size = 1.0; 

symbolArray.AddSymbol ((ISymbol)markSymbol); 


接着 创建 点 密度 着 色 器 对 象 ， 应 用 点 密度 填充 符号 ， 并 设置 每 个 点 代表 的 数量 。 代 码 如 下 : 


IDotDensityRenderer render = null; 

render - serverContext.CreateObject ("esriCarto.DotDensityRenderer") 
as IDotDensityRenderer; 

render.DotDensitySymbol = symbol; 

render.DotValue = 200000; 

render.ControlLayer = featurelyer; 

render.CreateLegend(); 


还 需要 加 入 字段 的 设置 。 代 码 如 下 : 


IRendererFields renderFields = render as IRendererFields; 


SIS gam 


// AN 
第 7 章 图 形 操作 < oes 
renderFields.AddField(field, field); 


将 该 着 色 器 应 用 到 图 层 以 及 刷新 地 图 与 Toc 控件 的 代码 ， 与 前 几 小 节 的 相同 。 
切换 到 Default.aspx.cs 文件 中 ， 找 到 GetCallbackResult 方法 ， 在 callbackArg 为 6 的 部 分 ， 加 
入 对 CreateDotDensityRenderer 方法 的 调用 。 代 码 如 下 : 


return GisFunctionality.CreateDotDensityRenderer (Mapl, Tocl, 1, "POP1999"); 


上 述 代 码 表示 ,针对 USAMap 地 图 资源 中 的 第 二 个 图 层 〈 即 美国 州 行政 区 划 ) 的 各 州 1999 年 
人 口 数 据 设置 点 密度 专题 图 。 

编译 并 运行 程序 ， 程 序 运 行 效果 如 图 7.13 所 示 ， 从 图 中 可 以 清楚 地 看 出 ， 美 国 东部 人 口 最 密 
集 ， 其 次 是 西部 ， 再 其 次 是 南部 与 中 部 ， 北 部 人 口 最 稀 下 。 
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图 7.13 点 密度 专题 图 


7.5 图 形 对 象 的 转换 


由 于 Web ADF 中 在 同一 应 用 程序 中 ， 可 以 同时 使 用 来 自 不 同 数据 源 的 数据 ， 而 且 每 个 数据 源 
可 以 独立 于 Web ADF， 利 用 自己 特有 的 API 进行 操作 ， 因 此 应 用 程序 既 要 处 理 来 自 客户 端的 图 形 
对 象 ， 又 要 处 理 来 自 GIS 服务 器 端 数据 源 的 图 形 对 象 ， 所 以 需要 开发 者 负责 转换 这 些 不 同类 型 的 
数据 。 在 这 一 节 中 ， 将 介绍 Web ADF 在 数据 类 型 转换 方面 提供 的 类 与 方法 。 

Web ADF 中 提供 了 各 种 转换 类 ， 在 不 同 的 命名 空间 中 以 静态 方法 的 方式 提供 。 命 名 空间 的 名 
称 表明 了 该 转换 类 处 理 的 数据 类 型 。 表 7-1 列 出 了 每 个 转换 类 的 功能 。 


b Web GIS 开发 一 一 ArcGIS Server 与 .NET 


表 7-1 不 同 命名 空间 中 转换 类 的 功能 


ES 描述 

ESRLArcGIS.ADF.ArcGISServer.Converter 处 理 ArcGIS Server 的 Web 服务 与 DCOM 代理 类 的 转 
换 

ESRLArcGIS.ADF.Converter 处 理 Web ADF 中 的 数据 类 型 

ESRI.ArcGIS.ADF.Web.Converter 将 NET 数据 集 转换 为 Web ADF 的 数据 集 ， 将 NET 的 
数据 表 转换 为 Web ADF 的 图 形 图 层 

ESRLArcGIS.ADF.Web.DataSources.ArcGISServer. 处 理 ArcGIS Server 中 COM 与 值 对 象 类 型 

Converter 


ESRLArcGIS.ADF.Web.DataSources.IMS.Converter ”处 理 ArcIMS 类 型 
ESRLArcGIS.ADF.Web.UI.WebControls.Converter ” 供 Web ADF 控件 内 部 使 用 


7.5.1 几何 类 型 的 转换 


GIS 应 用 和 服务 的 功能 都 是 和 空间 数据 相关 的 ， 以 处 理 和 分 析 空 间 数据 为 主 。 比 如 获得 鼠标 点 
击 的 点 ， 或 者 通过 空间 或 属性 查询 选择 要 素 等 。 在 每 个 层次 以 及 对 于 每 个 数据 源 ， 都 必须 管理 空间 
信息 ， 因 此 ， 每 个 层次 与 数据 源 都 提供 了 存储 与 操作 几何 类 型 的 方法 。 

假设 我 们 要 根据 用 户 在 浏览 器 中 的 地 图 上 绘制 的 一 个 点 ,计算 该 点 的 缓冲 区 , 并 用 该 缓冲 区 来 
选择 要 素 图 层 中 的 要 素 。 该 功能 的 实现 可 分 四 个 步骤 ， 如 图 7.14 所 示 。 
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图 7.14 利用 点 缓冲 区 查询 要 素 图 层 的 步骤 


COD 得 到 用 户 在 浏览 器 的 地 图 上 单 击 的 位 置 。 用 户 在 浏览 器 中 输入 的 点 使 用 的 屏幕 坐标 , Web 
ADF 中 使 用 .NET 的 绘图 类 库 (System.Drawing) 存储 屏幕 几何 类 型 。Web ADF 将 该 几何 类 型 从 屏 
幕 坐 标 转换 为 地 图 坐标 。Web ADF 使 用 自己 的 几何 类 型 类 库 来 操作 Web ADF 特有 功能 (例如 
GraphicsElementLayer 或 SpatialFilter) ， 扮 演 的 是 客户 端 到 服务 器 端 中 间 类 型 的 脚色 。 

(2) 使 用 ArcGIS Server 本 地 服务 计算 点 的 缓冲 区 。Web ADF 不 能 计算 点 的 缓冲 区 , 但 ArcGIS 
Server 本 地 数据 源 可 以 计算 几何 类 型 的 缓冲 区 , 并 返回 一 多 边 形 几何 类 型 。 为 了 利用 ArcGIS Server 
本 地 服务 的 缓冲 区 计算 功能 ， 我 们 需要 将 该 Web ADF 的 点 对 象 转换 为 ArcObjects 的 COM 对 象 。 

G) 在 地 图 中 的 Web ADF 图 形 图 层 中 显示 该 缓冲 区 结果 。ArcGIS Server 本 地 服务 返回 一 个 
ArcObjects 的 COM 类 型 的 多 边 形 ， 为 了 在 Web ADF 的 图 形 图 层 中 显示 该 多 边 形 ， 需 要 将 其 转换 
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为 Web ADF 的 多 边 形 。 

(4). 使 用 缓冲 区 在 ArcIMS 服务 中 选择 要 素 。 为 使 用 Web ADF 的 缓冲 区 多 边 形 选 择 ArcIMS 
服务 中 的 一 个 要 素 图 层 中 的 要 素 ， 需 要 将 其 转换 为 ArcIMS 类 型 的 多 边 形 。 如 果 仅 仅 需 要 查询 一 个 
图 层 ， 并 返回 一 组 要 素 ， 我 们 可 以 使 用 Web ADF 中 的 IQueryFunctionality 便 可 实现 。 然 而 我 们 希 
望 针对 某 一 特定 的 图 层 ， 因 此 需要 使 用 ArcIMS 的 API。 


在 上 述 步 又 中 , 使 用 了 4 个 不 同 的 API, 在 三 个 层次 操作 几何 类 型 : .NET、Web ADF. ArcGIS 
Server CArcObjects COM) 与 ArcIMS。 以 下 就 来 介绍 不 同 API 之 间 的 几何 类 型 的 转换 。 

在 下 面 的 代码 段 中 ， 使 用 了 如 下 两 个 变量 : 
D) tooleventargs， 表 示 一 自 定 义工 具 的 Web ADF 的 ToolEventArgs 参数 ; 
D) adf map， 表 示 Web ADF 地 图 控件 。 


1. 点 的 转换 
(1) 将 屏幕 上 的 点 转换 为 Web ADF 中 地 图 坐标 ， 方 法 如 下 : 
PointEventArgs pointargs = (PointEventArgs)tooleventargs; 


System.Drawing.Point screen point = pointargs.ScreenPoint; 
ESRI.ArcGIS.ADF.Web.Geometry.Point adf point = 
ESRI.ArcGIS.ADF.Web.Geometry.Point.ToMapPoint (screen point.X, 
Screen point.Y, 
adf map.GetTransformationParams (TransformationDirection.ToMap)); 


(2) 将 屏幕 上 的 点 转换 为 ArcGIS Server SOAP 的 点 ， 方 法 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.ImageDisplay imgDisp = 
new ESRI.ArcGIS.ADF.ArcGISServer.ImageDisplay(); 

imgDisp.ImageHeight = (int)adf map.Height.Value; 

imgDisp.ImageWidth = (int)adf map.Width.Value; 

int[] xvalues - new int[1]; 


xvalues[0] = screen point.X; 
int[] yvalues = new int[1]; 
yvalues[0] = screen point.Y; 


ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality 
ags mapfunctionality = adf map.GetFunctionality (0) 
as ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality; 


ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceBase 
ags mapresource = ags mapfunctionality.Resource 
as ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceBase; 
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ESRI.ArcGIS.ADF.ArcGISServer.MapServerProxy ags mapserverproxy = 
ags mapresource.MapServerProxy; 


ESRI.ArcGIS.ADF.ArcGISServer.MultipointN value multipoint = 
ags mapserverproxy.ToMapPoints( 
ags mapfunctionality.MapDescription,imgDisp, xvalues, yvalues) 
as ESRI.ArcGIS.ADF.ArcGISServer.MultipointN; 
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ESRI.ArcGIS.ADF.ArcGISServer.PointN value point = 
value multipoint.PointArray[0] as ESRI.ArcGIS.ADF.ArcGISServer.PointN; 


(3) 屏幕 上 的 点 转换 到 ArcIMS 的 点 ， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.DataSources.IMS.MapFunctionality ims mapfunctionality = 
(ESRI.ArcGIS.ADF.Web.DataSources.IMS.MapFunctionality) 
adf map.GetFunctionality (0); 


ESRI.ArcGIS.ADF.IMS.Carto.MapView mapview = ims mapfunctionality.MapView; 
ESRI.ArcGIS.ADF.IMS.Geometry.Envelope ims extent - mapview.Extent; 
ESRI.ArcGIS.ADF.IMS.Geometry.Point ims point = 
ESRI.ArcGIS.ADF.IMS.Geometry.Point.ToMapPoint ( 
Screen point, ims extent, 
mapview.ImageDescriptor.Width, 
mapview.ImageDescriptor.Height); 


(4) 将 Web ADF 的 点 转换 为 ArcObjects 的 点 ， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality 

ags mapfunctionality = adf map.GetFunctionality(ags local resource index) 
as ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality; 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceLocal 

ags mapresourcelocal - ags mapfunctionality.Resource 
as ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceLocal; 
ESRI.ArcGIS.Geometry.IPoint com point = (ESRI.ArcGIS.Geometry.IPoint) 


ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ToIGeometry (adf point, 
ags mapresourcelocal.ServerContextInfo.ServerContext); 


(5) Web ADF 的 点 转换 为 ArcIMS 的 点 ， 方 法 如 下 : 


ESRI.ArcGIS.ADF.IMS.Geometry.Point ims point = 
(ESRI.ArcGIS.ADF.IMS.Geometry.Point)ESRI.ArcGIS.ADF.Web.DataSources.IMS.C 
onverter.ToIMSGeometry (adf point); 


(6) ArcGIS Server SOAP 的 点 转换 为 Web ADF 的 点 ， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.Geometry.Point new adf point = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ToAdfPoint (value 
point); 


(7) ArcGIS Server ArcObjects 点 转换 为 Web ADF 点 ， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.Geometry.Point new adf point = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.FromIPoint (com 
point); 


(8) ArcIMS 点 转换 为 Web ADF 点 ， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.Geometry.Point new adf point = 
(ESRI.ArcGIS.ADF.Web.Geometry.Point) 
ESRI.ArcGIS.ADF.Web.DataSources.IMS.Converter.ToADFGeometry (ims point); 
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2. 线 的 转换 
(OD 屏幕 转换 到 Web ADF， 方 法 如 下 : 


VectorEventArgs vectorargs = (VectorEventArgs)tooleventargs; 

System.Drawing.Point[] Screen points = vectorargs.Vectors; 

ESRI.ArcGIS.ADF.Web.Geometry.PointCollection adf pointcollection = 
new ESRI.ArcGIS.ADF.Web.Geometry.PointCollection(); 


foreach (System.Drawing.Point screen point in screen points) 
t 
adf pointcollection.Add(ESRI.ArcGIS.ADF.Web.Geometry.Point.ToMapPoint 
(screen point, adf map.Extent, 
adf map.GetTransformationParams (TransformationDirection.ToMap)); 


ESRI.ArcGIS.ADF.Web.Geometry.Path adf path = 
new ESRI.ArcGIS.ADF.Web.Geometry.Path(); 
adf path.Points = adf pointcollection; 
ESRI.ArcGIS.ADF.Web.Geometry.PathCollection adf paths = 
new ESRI.ArcGIS.ADF.Web.Geometry.PathCollection(); 
adf paths.Add(adf path); 
ESRI.ArcGIS.ADF.Web.Geometry.Polyline adf polyline = 
new ESRI.ArcGIS.ADF.Web.Geometry.Polyline(); 
adf polyline.Paths - adf paths; 


(2) 屏幕 转换 到 ArcGIS Server SOAP， 方 法 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.ImageDisplay imgDisp = 
new ESRI.ArcGIS.ADF.ArcGISServer.ImageDisplay():; 

imgDisp.ImageHeight = (int)adf map.Height.Value; 

imgDisp.ImageWidth - (int)adf map.Width.Value; 


int[] xvalues - new int[screen points.Length]; 
int[] yvalues = new int[screen points.Length]; 


for (int i = 0; i < screen points.Length; i++) 


{ 


xvalues [i] Screen points[i].X; 
yvalues[i] = screen points[i].Y; 


ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality 
ags mapfunctionality = adf map.GetFunctionality (0) 
as ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality; 
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ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceBase 
ags mapresource = 
(ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceBase)ags 
mapfunctionality.Resource; 
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ESRI.ArcGIS.ADF.ArcGISServer.MapServerProxy ags mapserverproxy — 
ags mapresource.MapServerProxy; 


ESRI.ArcGIS.ADF.ArcGISServer.MultipointN value multipoint = 
(ESRI.ArcGIS.ADF.ArcGISServer.MultipointN) 
ags mapserverproxy.ToMapPoints (ags mapfunctionality.MapDescription, 
imgDisp, xvalues, yvalues); 


ESRI.ArcGIS.ADF.ArcGISServer.Path value path — 
new ESRI.ArcGIS.ADF.ArcGISServer.Path(); 
value path.PointArray - value multipoint.PointArray; 


ESRI.ArcGIS.ADF.ArcGISServer.Path[] value paths = 
new ESRI.ArcGIS.ADF.ArcGISServer.Path[1]; 
value paths.SetValue (value path, 0); 


ESRI.ArcGIS.ADF.ArcGISServer.PolylineN value polyline = 
new ESRI.ArcGIS.ADF.ArcGISServer.PolylineN(); 
value polyline.PathArray = value paths; 


G) 屏幕 转换 到 ArcIMS， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.DataSources.IMS.MapFunctionality ims mapfunctionality = 
(ESRI.ArcGIS.ADF.Web.DataSources.IMS.MapFunctionality) 
adf map.GetFunctionality (0); 
ESRI.ArcGIS.ADF.IMS.Carto.MapView mapview = ims mapfunctionality.MapView; 
ESRI.ArcGIS.ADF.IMS.Geometry.Envelope ims extent = mapview.Extent; 
ESRI.ArcGIS.ADF.IMS.Geometry.PointCollection ims pointcollection = 
new ESRI.ArcGIS.ADF.IMS.Geometry.PointCollection(); 
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foreach (System.Drawing.Point screen point in screen points) 
{ 
ESRI.ArcGIS.ADF.IMS.Geometry.Point ims point = 
ESRI.ArcGIS.ADF.IMS.Geometry.Point.ToMapPoint (screen point, 
ims extent, 
mapview.ImageDescriptor.Width, 
mapview.ImageDescriptor.Height); 
ims pointcollection.Add(ims point); 


ESRI.ArcGIS.ADF.IMS.Geometry.Path ims path = 
new ESRI.ArcGIS.ADF.IMS.Geometry.Path(); 
ims path.Points — ims pointcollection; 


ESRI.ArcGIS.ADF.IMS.Geometry.Polyline ims polyline = 
new ESRI.ArcGIS.ADF.IMS.Geometry.Polyline(); 
ims polyline.Paths.Add(ims path); 


(4) Web ADF 转换 到 ArcGIS Server SOAP， 方 法 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.PolylineN value polyline = 
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ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.FromAdfPolyline( 
adf polyline); 


(5) Web ADF 转换 到 ArcGIS Server ArcObjects， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality 
ags mapfunctionality 
(ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality) 

adf map.GetFunctionality (0); 


ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceLocal 
ags mapresourcelocal - 
(ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceLocal) 
ags mapfunctionality.Resource; 


ESRI.ArcGIS.Geometry.IPointCollection com polyline pointcollection 
(ESRI.ArcGIS.Geometry.IPointCollection) 


ags mapresourcelocal.ServerContextInfo.ServerContext.CreateObject ("esriGeometr 
y.Polyline"); 


object Missing - Type.Missing; 


foreach (ESRI.ArcGIS.ADF.Web.Geometry.Path new adf path 
in adf polyline.Paths) 
t 
ESRI.ArcGIS.Geometry.IPointCollection com pointcollection = 
(ESRI.ArcGIS.Geometry.IPointCollection)ags mapresourcelocal.Server 
ContextInfo.ServerContext.CreateObject ("esriGeometry.Path"); 
foreach (ESRI.ArcGIS.ADF.Web.Geometry.Point new adf point 
in new adf path.Points) 
{ 

ESRI.ArcGIS.Geometry.IPoint com point = (ESRI.ArcGIS.Geometry.IPoint) 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ToIGeometry (new adf poi 
DE; 

ags mapresourcelocal.ServerContextInfo.ServerContext); 
com pointcollection.AddPoint(com point, ref Missing, ref Missing); 
) 


com polyline pointcollection.AddPointCollection (com pointcollection); 


ESRI.ArcGIS.Geometry.IPolyline com polyline - 
(ESRI.ArcGIS.Geometry.IPolyline)com polyline pointcollection; 


(6) Web ADF 转换 到 ArcIMS， 方 法 如 下 : 


ESRI.ArcGIS.ADF.IMS.Geometry.Polyline ims polyline = 
(ESRI.ArcGIS.ADF.IMS.Geometry.Polyline)ESRI.ArcGIS.ADF.Web.DataSources 
-IMS.Converter.ToIMSGeometry (adf polyline); 
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(7) ArcGIS Server SOAP 转换 到 Web ADF， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.Geometry.Point new adf polyline = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ToAdfPolyline( 
value polyline); 


(8) ArcGIS Server ArcObjects 转换 到 Web ADF， 方 法 如 下 : 


ESRI.ArcGIS.Geometry.IPointCollection com pointcollection - 
(ESRI.ArcGIS.Geometry.IPointCollection)com polyline; 


ESRI.ArcGIS.ADF.Web.Geometry.Point[] new adf points - 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.FromIPointCollection (co 
m pointcollection); 


ESRI.ArcGIS.ADF.Web.Geometry.PointCollection new adf pointcollection - new 
ESRI.ArcGIS.ADF.Web.Geometry.PointCollection(); 


for (int i = 0; i < new adf points.Length - 1; i++) { 
new adf pointcollection.Add(new adf points[i]); 
) 
ESRI.ArcGIS.ADF.Web.Geometry.Path new adf path - new 
ESRI.ArcGIS.ADF.Web.Geometry.Path(); 


new adf path.Points = new adf pointcollection; 
ESRI.ArcGIS.ADF.Web.Geometry.PathCollection new adf pathcollection = 


new ESRI.ArcGIS.ADF.Web.Geometry.PathCollection(); 
adf pathcollection.Add(new adf path); 


ESRI.ArcGIS.ADF.Web.Geometry.Polyline new adf polyline 
new ESRI.ArcGIS.ADF.Web.Geometry.Polyline(); 
new adf polyline.Paths - new adf pathcollection; 


(9) ArcIMS 转换 到 Web ADF， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.Geometry.Polyline new adf polyline 
(ESRI.ArcGIS.ADF.Web.Geometry.Polyline)ESRI.ArcGIS.ADF.Web.DataSources. 
IMS.Converter.ToADFGeometry (ims polyline); 


3. 多 边 形 的 转换 
d) 屏幕 转换 到 Web ADF， 方 法 : 


VectorEventArgs vectorargs = (VectorEventArgs)tooleventargs; 
System.Drawing.Point[] screen points = vectorargs.Vectors; 


ESRI.ArcGIS.ADF.Web.Geometry.PointCollection adf pointcollection = new 
ESRI.ArcGIS.ADF.Web.Geometry.PointCollection(); 
foreach (System.Drawing.Point screen point in screen points) ( 
adf pointcollection.Add(ESRI.ArcGIS.ADF.Web.Geometry.Point.ToMapPoint ( 
Screen point, adf map.Extent, 


第 7 章 MERKEA w 


adf map.GetTransformationParams (TransformationDirection.ToMap)); 


ESRI.ArcGIS.ADF.Web.Geometry.Ring adf ring = 
new ESRI.ArcGIS.ADF.Web.Geometry.Ring(); 
adf ring.Points - adf pointcollection; 
ESRI.ArcGIS.ADF.Web.Geometry.RingCollection adf rings = 
new ESRI.ArcGIS.ADF.Web.Geometry.RingCollection(); 
adf rings.Add(adf ring); 
ESRI.ArcGIS.ADF.Web.Geometry.Polygon adf polygon = 
new ESRI.ArcGIS.ADF.Web.Geometry.Polygon(); 
adf polygon.Rings - adf rings; 


(2) 屏幕 转换 到 ArcGIS Server SOAP， 方 法 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.ImageDisplay imgDisp = 

new ESRI.ArcGIS.ADF.ArcGISServer.ImageDisplay(); 
imgDisp.ImageHeight = (int)adf map.Height.Value; 
imgDisp.ImageWidth = (int)adf map.Width.Value; 


int[] xvalues = new int[screen points.Length]; 
int[] yvalues = new int[screen points.Length]; 


for (int i = 0; i < screen points.Length; i++) ( 
xvalues[i] screen points[i].X; 
yvalues[i] = screen points[i].Y; 


ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality 
ags mapfunctionality = 

(ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality) 
adf map.GetFunctionality (0); 


ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceBase 
ags mapresource = 

(ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceBase) 
ags mapfunctionality.Resource; 


ESRI.ArcGIS.ADF.ArcGISServer.MapServerProxy ags mapserverproxy = 
ags mapresource.MapServerProxy; 


ESRI.ArcGIS.ADF.ArcGISServer.MultipointN value multipoint = 
(ESRI.ArcGIS.ADF.ArcGISServer.MultipointN)ags mapserverproxy.ToMapPoints 
(ags mapfunctionality.MapDescription,imgDisp, xvalues, yvalues); 


ESRI.ArcGIS.ADF.ArcGISServer.Ring value ring - new 
ESRI.ArcGIS.ADF.ArcGISServer.Ring(); 
value ring.PointArray = value multipoint.PointArray; 


ESRI.ArcGIS.ADF.ArcGISServer.Ring[] value rings = new 
ESRI.ArcGIS.ADF.ArcGISServer.Ring[1]; 
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value rings.SetValue (value ring, 0); 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonN value polygon = new 
ESRI.ArcGIS.ADF.ArcGISServer.PolygonN(); 
value polygon.RingArray - value rings; 


G) 屏幕 转换 到 ArcIMS， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.DataSources.IMS.MapFunctionality ims mapfunctionality 
—-(ESRI.ArcGIS.ADF.Web.DataSources.IMS.MapFunctionality) 
adf map.GetFunctionality (0); 

ESRI.ArcGIS.ADF.IMS.Carto.MapView mapview = ims mapfunctionality.MapView; 


ESRI.ArcGIS.ADF.IMS.Geometry.Envelope ims extent - mapview.Extent; 


ESRI.ArcGIS.ADF.IMS.Geometry.PointCollection ims pointcollection = new 
ESRI.ArcGIS.ADF.IMS.Geometry.PointCollection(); 


foreach (System.Drawing.Point screen point in screen points) 
{ 
ESRI.ArcGIS.ADF.IMS.Geometry.Point ims point = 
ESRI.ArcGIS.ADF.IMS.Geometry.Point.ToMapPoint (screen point, 
ims extent, 
mapview.ImageDescriptor.Width, 
mapview.ImageDescriptor.Height); 
ims pointcollection.Add(ims point); 


ESRI.ArcGIS.ADF.IMS.Geometry.Ring ims ring = 
new ESRI.ArcGIS.ADF.IMS.Geometry.Ring(); 
ims ring.Points = ims pointcollection; 


ESRI.ArcGIS.ADF.IMS.Geometry.Polygon ims polygon = 
new ESRI.ArcGIS.ADF.IMS.Geometry.Polygon(); 
ims polygon.Rings.Add(ims ring); 


(4) Web ADF 转换 到 ArcGIS Server SOAP 方法 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonN value polygon - 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.FromAdfPolygon (adf poly 
gon); 


(5) Web ADF 转换 到 ArcGIS Server ArcObjects， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality 
ags mapfunctionality = 

(ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapFunctionality) 
adf map.GetFunctionality (0); 


ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceLocal 
ags mapresourcelocal - 
(ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.MapResourceLocal) 
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ags mapfunctionality.Resource; 


ESRI.ArcGIS.Geometry.IPolygon com polygon = (ESRI.ArcGIS.Geometry.IPolygon) 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ToIGeometry (adf polygon, 
ags mapresourcelocal.ServerContextInfo.ServerContext); 


(6) Web ADF 转换 到 ArcIMS， 方 法 如 下 : 


ESRI.ArcGIS.ADF.IMS.Geometry.Polygon ims polygon = 
(ESRI.ArcGIS.ADF.IMS.Geometry.Polygon)ESRI.ArcGIS.ADF.Web.DataSources 
-IMS.Converter.ToIMSGeometry (adf polygon); 


(7) ArcGIS Server SOAP 转换 到 Web ADF， 方 法 如 下 : 


ESRI.ArcGIS.ADF.Web.Geometry.Polygon new adf polygon = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ToAdfPolygon( 
value polygon); 


(8) ArcGIS Server ArcObjects 转换 到 Web ADF， 方 法 如 下 : 


ESRI.ArcGIS.Geometry.IPointCollection com pointcollection = 
(ESRI.ArcGIS.Geometry.IPointCollection)com polygon; 
ESRI.ArcGIS.ADF.Web.Geometry.Point[] new adf points = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.FromIPoint 
Collection (com pointcollection); 
ESRI.ArcGIS.ADF.Web.Geometry.PointCollection new adf pointcollection - new 
ESRI.ArcGIS.ADF.Web.Geometry.PointCollection(); 


for (int i = 0; i < new adf points.Length - 1; i++) 
{ 
new adf pointcollection.Add(new adf points[i]):; 
} 
ESRI.ArcGIS.ADF.Web.Geometry.Ring new adf ring = 
new ESRI.ArcGIS.ADF.Web.Geometry.Ring(); 


new adf ring.Points = new adf pointcollection; 

ESRI.ArcGIS.ADF.Web.Geometry.RingCollection new adf ringcollection - 
new ESRI.ArcGIS.ADF.Web.Geometry.RingCollection(); 

new adf ringcollection.Add(new adf ring); 

ESRI.ArcGIS.ADF.Web.Geometry.Polygon new adf polygon 
new ESRI.ArcGIS.ADF.Web.Geometry.Polygon(); 

new adf polygon.Rings - new adf ringcollection; 


(9) ArcIMS 转换 到 Web ADF 方法 如 下 : 


[i 


ESRI.ArcGIS.ADF.Web.Geometry.Polygon new adf polygon 
(ESRI.ArcGIS.ADF.Web.Geometry.Polygon)ESRI.ArcGIS.ADF.Web.DataSources 
-IMS.Converter.ToADFGeometry (ims polygon); 
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7.5.2 ArcGIS Server 中 COM 对 象 与 值 对 象 的 转换 


当 使 用 ArcGIS Server 时 ，Web ADF 控件 与 公有 API 使 用 无 状态 的 ArcGIS Server SOAP API, 
该 API 中 包含 了 一 组 值 对 象 与 代理 类 。ArcGIS Server 远程 数据 源 使 用 Web 服务 代理 ， 将 值 对 象 序 
列 化 为 SOAP， 并 通过 IRequestHandler 接口 ， 直 接 使 用 服务 器 对 象 。 不 管 是 通过 远程 连接 还 是 本 
地 连接 访问 服务 器 对 象 的 SOAP 接口 ，ArcGIS Server SOAP API 的 使 用 与 限制 是 一 样 的 。 然 而 ， 如 
果 使 用 ArcGIS Server 本 地 数据 源 , 便 可 以 访问 服务 器 上 下 文 , 也 就 可 以 通过 GIS 服务 器 上 的 COM, 
访问 ArcObjects API。 

ArcGIS Server SOAP API 只 提供 了 ArcGIS Server ArcObjects API 部 分 功能 。 由 于 Web ADF 使 
用 SOAP API 实现 ArcGIS Server 数据 源 ， 因 此 为 了 利用 ArcObjects， 就 需要 在 ArcObjects 的 COM 
对 象 与 SOAP 的 值 对 象 之 间 进 行 转换 。 

ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter 类 中 提供 了 两 个 方法 来 实现 上 述 
转换 : 

(1) COMObjectToValueObject(object, ESRIArcGIS.Server.IServerContext System.Type) 一 一 返 

回 一 个 ArcGIS Server SOAP API 值 对 象 ; 


ESRI.ArcGIS.ADF.ArcGISServer.PolylineN value polyline = 
(ESRI.ArcGIS.ADF.ArcGISServer.PolylineN)ESRI.ArcGIS.ADF.ArcGISServer. 
Converter.ComObjectToValueObject (com polyline, servercontext, typeof (ESRI.ArcGIS 
.ADF.ArcGISServer.PolylineN)); 
(2) ValueObjectToCOMObject(object, ESRI.ArcGIS.Server.IServerContext) ——3& [p] — ArcGIS 
Server ArcObjects API COM 对 象 。 
ESRI.ArcGIS.Geometry.IPolyline com polyline = 
(ESRI.ArcGIS.Geometry.IPolyline)ESRI.ArcGIS.ADF.ArcGISServer.Converter 
.ValueObjectToComObject (value polyline, servercontext); 
由 于 SOAP API 是 ArcObjects API 的 一 部 分 , 因此 每 个 值 对 象 有 一 个 对 应 的 COM 对 象 ,但 是 ， 
不 是 所 有 的 COM 对 象 都 有 一 个 对 应 的 值 对 象 。 表 7-2 列 出 了 值 对 象 与 COM 对 象 之 间 的 有 效 转 换 。 


表 7-2 值 对 象 与 COM 对 象 之 间 的 有 效 转换 


值 对 象 类 型 ArcObjects 的 COM 对 象 类 型 
PointN ESRLArcGIS.Geometry.IPoint 

Line ESRLATrcGIS.Geometry.ILine 
PolylineN ESRI ArcGIS.Geometry.IPolyline 
PolygonN ESRLATrcGIS.Geometry.IPolygon 
MapbDescription ESRLATrcGIS.Carto.IMapDescription 
GraphicsElement[] ESRLATrcGIS.Carto.IGraphicElements 
Field ESRLATrcGIS.Geodatabase.IField 


RecordSet ESRLArcGIS.Geodatabase.IRecordSet 


7.5.3 数据 集 转 换 


操作 数据 源 时 ， 常常 需要 处 理 表 格 形式 的 数据 。 在 大 多 数 情 况 下 ,数据 表 的 转换 需要 使 用 数据 
源 特有 的 API 方法 、 属 性 与 技术 。 为 有 效 处 理 数 据 源 特有 的 数据 集 ， 以 及 操作 通用 的 标准 的 
ADO.NET 数据 结构 , Web ADF 提供 了 一 组 功能 方法 。 这 些 方法 可 用 于 将 数据 源 特有 的 表格 数据 转 
换 为 ADO.NET 的 DataTable 与 Web ADF 的 GraphicsLayer 类 型 。 

为 将 ” ArcGIS Server ArcObjects 的 ”ESRIArcGIS.Geodatabase.IRecordSet 或 
ESRI.ArcGIS.ADF.ArcGISServer.RecordSet 转换 为 ADO.NET 的 System.Data.DataTable， 可 使 用 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer 命名 空间 中 的 如 下 静态 方法 。 在 转换 之 前 ， 需 要 
使 用 前 一 中 介绍 的 ComObjectToValueObject 方法 ， 将 ArcObjects 类 型 的 转换 为 一 SOAP 值 对 象 ， 
然后 使 用 如 下 方法 : 

ToDataTable(ESRI.ArcGIS.ADF.ArcGISServer.RecordSet) 

如 果 ArcGIS Server RecordSetC 记录 集 ) 值 对 象 中 的 一 列 包含 几何 类 型 值 对 象 , 可 将 该 RecordSet 
转换 为 Web ADF 要 素 图 形 图 层 ， 在 地 图 控件 中 显示 。 使 用 下 面 的 静态 方法 返回 一 个 
ESRLArcGIS.ADF.Web.Display.Graphics.FeatureGraphicsLayer 对 象 : 


ToFeatureGraphicsLayer(ESRI.ArcGIS.ADF.ArcGISServer.RecordSet recordSet) 


Web ADF 公有 API 定义 了 一 个 IQueryFunctionality 接口 ， 如 果 某 数据 源 实现 了 该 接口 ， 那 么 
就 可 用 来 查询 该 数据 源 的 数据 图 层 。 查 询 返 回 的 数据 的 格式 是 ADO.NET DataTable 对 象 。 然 而 ， 
该 对 象 通常 包含 Web ADF 几何 类 型 ， 可 用 来 在 地 图 控件 中 显示 。 这 时 不 需要 从 头 创建 Web ADF 
图 形 图 层 ， 可 使 用 ESRI.ArcGIS.ADF.Web.Converter 类 的 如 下 静态 方法 创建 图 形 图 层 : 


ToGraphicsLayer (System.Data.DataTable) 


如 果 在 数据 表 中 的 所 有 Web ADF 几何 类 型 同一 类 型 ， 那 么 返回 的 是 一 
ESRI.ArcGIS.ADF.Web.Display.Graphics.FeatureGraphicsLayer。 如果 属 于 不 同类 型 ， 返 回 的 是 一 
ESRI.ArcGIS.ADF.Web.Display.Graphics.ElementGraphicsLayer。 不 管 是 哪 种 情况 ， 都 可 以 将 该 图 形 
图 层 加 入 到 Web ADF 的 图 形 资源 中 。 下 面 的 代码 演示 了 如 何 完成 上 述 功能 : 


System.Data.DataTable datatable = queryfunctionality.Query( 
null, layerids[layer index], adf spatialfilter); 
ESRI.ArcGIS.ADF.Web.Display.Graphics.GraphicsLayer graphicslayer = 
Converter.ToGraphicsLayer(datatable, Color.Yellow, Color.Yellow); 
ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource graphicsresource = 
null; 
foreach (IGISFunctionality gisfunctionality in gisfunctionalitycollection) 
t 
if (gisfunctionality.Resource.Name == "Selection") ( 
graphicsresource = 
(ESRI.ArcGIS.ADF.Web.DataSources.Graphics.MapResource)gfunc 
.Resource; 
graphicsresource.Graphics.Tables.Clear(); 


) 
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} 
graphicsresource.Graphics.Tables.Add (graphicslayer); 


7.5.4 缓冲 区 分 析 


所 谓 缓冲 区 就 是 地 理 空间 目标 的 一 种 影响 范围 或 服务 范围 。 缓 冲 区 分 析 是 GIS 中 最 重要 的 空 
间 分 析 之 一 。 本 节 将 通过 点 、 线 、 多 边 形 的 缓冲 区 分 析 ， 介 绍 图 形 对 象 在 客户 端 、Web 端 以 及 GIS 
服务 器 端 之 间 的 转换 。 

在 Visual Studio 2005 中 ， 利 用 File 菜单 的 New Web Site 创建 一 个 新 的 站 点 ， 命 名 为 
BufferAnalysis。 

在 Default.aspx 页 面 中 增加 一 地 图 资源 管理 器 控件 、 一 地 图 控件 、 一 工具 栏 控件 与 一 Toc 控件 。 
通过 地 图 资源 管理 器 控件 的 MapResourcesItem 属性 设置 对 话 框 ， 加 入 USAMap 地 图 资源 。 并 通过 
工程 的 右键 菜单 的 Add ArcGIS Identity 命令 ， 加 入 连接 USAMap 地 图 资源 的 身份 信息 。 

按照 4.4 节 中 介绍 的 自 定 义工 具 的 操作 ， 在 工具 栏 控件 加 入 放大 、 缩 小 、 漫 游 与 全 图 工具 或 命 
令 ， 并 加 入 三 个 自 定 义工 具 ， 分 别 用 于 点 、 线 与 多 边 形 的 缓冲 区 分 析 。 工 具 栏 控件 中 这 三 个 工具 在 
Default.aspx 中 的 代码 如 下 : 


<esri:Tool ClientAction-"Point" Name-"PointBuffer" 
DefaultImage-"-/Images/point.gif" HoverlImage-"-/Images/pointU.gif" 
JavaScriptFile-"" SelectedImage-"-/Images/pointD.gif" 
ServerActionAssembly-"App Code" 
ServerActionClass-"PointBuffer" 
ToolTip=" 点 缓冲 区 分 析 "” /> 

Xesri:Tool ClientAction-"Polyline" Name-"LineBuffer" 
DefaultImage-"-/Images/polyline.gif" 
HoverlImage-"-/Images/polylineU.gif" 
SelectedImage-"-/Images/polylineD.gif" 
ServerActionAssembly-"App Code" 
ServerActionClass-"LineBuffer" 
ToolTip=" 线 缓冲 区 分 析 " JavaScriptFile-"" /> 

<esri:Tool ClientAction-"Polygon" Name-"PolygonBuffer" 
DefaultImage-"-/Images/polygon.gif" 
HoverImage-"-/Images/polygonU.gif" 
SelectedImage-"-/Images/polygonD.gif" 
ServerActionAssembly-"App Code" 
ServerActionClass-"PolygonBuffer" 
ToolTip=" 多 边 形 缓冲 区 分 析 " JavaScriptFile-"" /> 


上 述 代 码 指 明 工具 使 用 的 图 标 位 于 工程 的 Images 文件 夹 中 ， 因 此 需要 读者 从 本 书 配 套 的 源 代 
码 文 件 中 拷贝 这 些 图 片 文件 。 代 码 也 指明 了 每 个 工具 处 理 类 。 
在 工程 中 加 入 ASPNET 的 标准 文件 夹 App_Code。 


1. 点 缓冲 区 分 析 
在 App Code 文件 夹 中 新 增加 一 个 C# 类 ， 命 名 为 PointBuffer. 
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在 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.UI.WebControls; 

using ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools; 
using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 


修改 类 的 声明 代码 ， 增 加 IMapServerToolAction 接口 的 支持 。 代 码 如 下 : 

public class PointBuffer : IMapServerToolAction 

利用 集成 开发 环境 的 代码 自动 生成 功能 , 创建 IMapServerToolAction 接口 的 实现 框架 。 该 接口 
中 只 有 一 个 方法 ， 即 : 


void IMapServerToolAction.ServerAction(ToolEventArgs args) { 


) 
首先 需要 将 屏幕 坐标 的 点 转换 为 地 图 坐标 的 点 ， 代 码 如 下 : 


// 从 方法 的 参数 中 得 到 地 图 控件 的 引用 

Map map = args.Control as Map; 

// 从 方法 的 参数 中 得 到 用 户 单 击 位 置 的 点 

PointEventArgs pea = (PointEventArgs)args; 

System.Drawing.Point screen point - pea.ScreenPoint; 

// 将 屏幕 坐标 的 点 转换 为 地 图 坐标 的 点 

Point adf map point = Point.ToMapPoint (screen point.X, screen point.Y, 
map.Extent, (int)map.Width.Value, (int)map.Height.Value); 


然后 利用 如 下 代码 将 Web ADF 的 点 对 象 转换 为 ArcGIS Server 的 点 对 象 ; 


ESRI.ArcGIS.ADF.ArcGISServer.PointN ags map point; 
ags map point = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.FromAdfPoint( 
adf map point); 


由 于 缓冲 区 分 析 需 要 使 用 的 是 COM 对 象 ， 因 此 需要 先 得 到 服务 器 上 下 文 对 象 。 代 码 如 下 : 


MapFunctionality mf; 
mf = (MapFunctionality)map.GetFunctionality ("USAMap") ; 
if (mf == null) 
return; 
MapResourceLocal mrl; 
mrl = (MapResourceLocal)mf.MapResource; 
ESRI.ArcGIS.Server.IServerContext serverContext = 
mrl.ServerContextInfo.ServerContext; 


得 到 服务 器 上 下 文 对 象 后 ， 便 可 以 将 点 对 象 转换 为 COM 对 象 ， 然 后 利用 ITopologicalOperator 
接口 的 Buffer 方法 ， 进 行 缓冲 区 分 析 ， 得 到 一 多 边 形 结果 。 由 于 该 方法 既 可 以 用 于 点 的 缓冲 区 分 
析 ， 又 可 以 用 于 线 与 多 边 形 的 缓冲 区 分 析 ， 因 此 我 们 将 该 过 程 提取 出 来 ， 单 独 形成 一 个 静态 方法 。 
同时 由 于 在 ArcGIS Server 中 多 个 命名 空间 都 有 点 、 线 、 多 边 形 等 类 ， 因 此 为 了 避免 它们 之 间 的 冲 
突 ， 我 们 将 该 方法 放 在 另 一 个 辅助 类 中 。 

再 在 App Code 文件 夹 中 新 增加 一 个 C# 类 ， 命 名 为 BufferHelper。 
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加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.Carto; 
using ESRI.ArcGIS.ADF.ArcGISServer; 
using ESRI.ArcGIS.Geometry; 


然后 加 入 根据 一 个 Web ADF 的 几何 类 型 对 象 ， 进 行 缓冲 区 分 析 的 方法 。 代 码 如 下 : 


public static ESRI.ArcGIS.Geometry.IPolygon Buffer( 
ESRI.ArcGIS.Server.IServerContext serverContext, 
ESRI.ArcGIS.ADF.ArcGISServer.Geometry ags map geo) 
t 


IGeometry geo = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ValueObject 
ToComObject(ags map geo, serverContext) as ESRI.ArcGIS.Geometry.IGeometry; 


ITopologicalOperator topop - (ITopologicalOperator)geo; 
double bufferdistance - 1; 


return (ESRI.ArcGIS.Geometry.IPolygon)topop.Buffer (bufferdistance); 
} 


上 述 代码 中 首先 将 Web ADF 的 几何 类 型 对 象 ， 转 换 为 COM 对 象 ， 然 后 利用 
ITopologicalOperator 接口 的 Buffer 方法 ， 进 行 缓冲 区 分 析 。 

回 到 PointBuffer 类 的 ServerAction 方法 中 ， 在 代码 的 最 后 加 入 对 上 述 方法 的 调用 ， 得 到 缓冲 
区 分 析 结 果 。 代 码 如 下 : 


ESRI.ArcGIS.Geometry.IPolygon bufferpolygon = 
BufferHelper.Buffer(serverContext, ags map point); 


然后 需要 实现 的 是 根据 该 缓冲 区 多 边 形 , 对 美国 各 县 进行 空间 查询 , 得 到 与 该 多 边 形 相交 的 要 
素 。 代 码 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonN[] queryResults = 
BufferHelper.Query(serverContext, bufferpolygon); 


上 行 代码 实际 调用 的 是 BufferHelper 类 的 Query 方法 实现 查询 。 该 方法 的 实现 代码 如 下 : 


public static PolygonN[] Query( 
ESRI.ArcGIS.Server.IServerContext serverContext, 
ESRI.ArcGIS.Geometry.IPolygon polygon) 

{ 


IMapServer mapServer = serverContext.ServerObject as IMapServer; 


IMapServerInfo mapInfo = 
mapServer.GetServerInfo (mapServer.DefaultMapName); 
IMapDescription mapDesc - mapInfo.DefaultMapDescription; 


IImageDisplay imgDisp = new ESRI.ArcGIS.Carto.ImageDisplay(); 
imgDisp.Height = 500; 

imgDisp.Width = 500; 

imgDisp.DeviceResolution = 96; 
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// 只 对 ID 为 2 的 图 层 进行 查询 ， 也 就 是 美国 县 级 行政 区 划 图 层 
ESRI.ArcGIS.esriSystem.ILongArray layerIds = 

new ESRI.ArcGIS.esriSystem.LongArray(); 
layerIds.Add (2); 


IMapServerIdentifyResults results = mapServer.Identify (mapDesc, imgDisp, 
polygon, 0, ESRI.ArcGIS.Carto.esrildentifyOption.esrildentifyAllLayers, 
layerIds); 


PolygonN[] resultPolygons - new PolygonN[results.Count]; 

for (int i = 0; i < results.Count; i++) ( 
IMapServerIdentifyResult result = results.get Element (i); 
ESRI.ArcGIS.Geometry.IGeometry geo = result.Shape; 
resultPolygons[i] = 

ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ComObject 
ToValueObject(geo, serverContext, typeof(PolygonN)) as PolygonN; 
) 


return resultPolygons; 


) 


下 面 要 完成 的 工作 就 是 显示 这 些 几 何 图 形 对 象 。 我 们 这 里 使 用 服务 器 端的 方法 进行 绘制 。 先 得 
到 MapDescription 对 象 ， 代 码 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.MapDescription mapDescription = 
mf.MapDescription; 


我 们 要 绘制 的 是 用 户 单 击 的 点 、 该 点 的 缓冲 区 以 及 缓冲 区 查询 结果 , 因此 需要 利用 代码 的 代码 
创建 图 形 元 素 对 象 : 


ESRI.ArcGIS.ADF.ArcGISServer.GraphicElement[] ges; 
ges - 
new ESRI.ArcGIS.ADF.ArcGISServer.GraphicElement [2 * queryResults.Length]; 


然后 需要 逐一 设置 这 些 图 形 元 素 对 象 。 先 设置 缓冲 区 查询 结果 部 分 的 图 形 要 素 对 象 。 代 码 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.SimpleFillSymbol querySym = 
AdfHelper.CreateSolidFillSymbol(255, 0, 0); 

for (int i = 0; i < queryResults.Length; i++) 

t 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement queryPolygon; 
queryPolygon - new ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement () ; 
queryPolygon.Symbol = querySym; 
queryPolygon.Polygon = queryResults[i]; 
ges[i] = queryPolygon; 

) 


在 上 述 代 码 中 ， 先 利用 AdfHelper 类 的 CreateSolidFillSymbol 方法 创建 一 实 填充 符号 ， 然 后 
利用 一 个 循环 ， 绘 制 查询 结果 中 的 每 个 多 边 形 。 

在 App Code 文件 夹 中 新 增加 一 个 C# 类 ， 命 名 为 AdfHelper. 

在 该 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 
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using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.ArcGISServer; 


然后 加 入 创建 实 填充 符号 CreateSolidFillSymbol 方法 。 代 码 如 下 : 


public static SimpleFillSymbol CreateSolidFillSymbol( 
byte red, byte green, byte blue) ( 
SimpleFillSymbol querySym = new SimpleFillSymbol(); 
querySym.Style esriSimpleFillStyle.esriSFSSolid; 
querySym.Color CreateColor(red, green, blue); 
return querySym; 


Ii 


public static RgbColor CreateColor (byte red, byte green, byte blue) { 
RgbColor rgb = new RgbColor(); 
rgb.Red - red; 
rgb.Green - green; 
rgb.Blue - blue; 
rgb.AlphaValue - 255; 
return rgb; 


) 
回 到 PointBuffer 类 的 ServerAction 方法 中 ,在 代码 的 最 后 加 入 如 下 代码 ,将 COM 类 型 的 


缓冲 区 对 象 转换 为 Web ADF 的 多 边 形 对 象 : 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonN buffer polyn; 
buffer polyn = 
(ESRI.ArcGIS.ADF.ArcGISServer.PolygonN)ESRI.ArcGIS.ADF.Web.DataSources 


.ArcGISServer.Converter.ComObjectToValueObject (bufferpolygon, serverContext, 
typeof (ESRI.ArcGIS.ADF.ArcGISServer.PolygonN)); 


然后 加 入 绘制 缓冲 区 多 边 形 对 象 的 代码 。 代 码 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.LineSymbol lnSymbol = null; 
lnSymbol = new ESRI.ArcGIS.ADF.ArcGISServer.SimpleLineSymbol(); 
lnSymbol.Color AdfHelper.CreateColor(0, 255, 0); 
lnSymbol.Width 1; 
ESRI.ArcGIS.ADF.ArcGISServer.SimpleFillSymbol sfsl = 
AdfHelper.CreateFillSymbol(255, 255, 0, l1nSymbol); 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement bufferPolyElement; 
bufferPolyElement = new ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement(); 
bufferPolyElement.Symbol = sfsl; 

bufferPolyElement.Polygon = buffer polyn; 


在 上 述 代 码 中 利用 AdfHelper 类 的 CreateFillSymbol 静态 方法 ， 创 建 一 交叉 线 填 充 的 符号 ， 


然后 创建 一 多 边 形 元 素 。 


AdfHelper 类 的 CreateFillSymbol 静态 方法 的 代码 如 下 : 


public static SimpleFillSymbol CreateFillSymbol( 
byte red, byte green, byte blue, LineSymbol outline) 
1 
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SimpleFillSymbol querySym = new SimpleFillSymbol (); 
querySym.Style = esriSimpleFillStyle.esriSFSCross; 
querySym.Color = CreateColor (red, green, blue); 
querySym.Outline = outline; 
return querySym; 

) 


回 到 PointBuffer 类 的 ServerAction 方法 中 ， 在 代码 的 最 后 加 入 绘制 用 户 在 地 图 上 单 击 的 点 。 
代码 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.SimpleMarkerSymbol sms; 

sms = new ESRI.ArcGIS.ADF.ArcGISServer.SimpleMarkerSymbol (); 

sms.Style = 
ESRI.ArcGIS.ADF.ArcGISServer.esriSimpleMarkerStyle.esriSMSCircle; 

sms.Color - AdfHelper.CreateColor(0, 255, 0); 

sms.Size = 5.0; 


ESRI.ArcGIS.ADF.ArcGISServer.MarkerElement marker; 

marker = new ESRI.ArcGIS.ADF.ArcGISServer.MarkerElement (); 
marker.Symbol = sms; 

marker.Point = ags map point; 


然后 将 缓冲 区 多 边 形 元 素 与 上 述 点 元 素 设置 给 图 形 元 素数 组 ， 代 码 如 下 : 


ges[queryResults.Length] = bufferPolyElement; 
ges[queryResults.Length + 1] = marker; 


最 后 将 该 图 形 元 素数 组 赋 给 MapDescription 对 象 的 CustomGraphics 属性 ， 并 刷新 地 图 。 代 码 如 下 : 


mapDescription.CustomGraphics = ges; 
map.Refresh(); 


编译 并 运行 程序 , 通过 点 缓冲 区 工具 , 在 地 图 上 单 击 , 便 可 在 地 图 上 显示 该 点 的 缓冲 区 以 及 该 
缓冲 区 影响 的 县 。 效 果 如 图 7.15 所 示 。 
F Untitled Page — Microsoft Internet Explorer 
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2. 线 缓冲 区 分 析 


在 App Code 文件 夹 中 新 增加 一 C# 类 ， 命 名 为 LineBuffer。 
在 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 
using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.UI.WebControls; 


using ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools; 
using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 


修改 类 的 声明 代码 ， 增 加 对 IMapServerToolAction 接口 的 支持 。 代 码 如 下 : 

public class LineBuffer : IMapServerToolAction 

利用 集成 开发 环境 的 代码 自动 生成 功能 , 创建 IMapServerToolAction 接口 的 实现 框架 。 该 接口 
中 同样 只 有 一 个 方法 ， 即 : 


void IMapServerToolAction.ServerAction (ToolEventArgs args) { 


} 
首先 需要 将 屏幕 坐标 的 线 转换 为 地 图 坐标 的 线 ， 代 码 如 下 : 


Map map = args.Control as Map; 
VectorEventArgs vectorargs - (VectorEventArgs)args; 
Polyline mapPoly - ConvertHelper.GetMapPolyline (map, vectorargs); 


上 述 代码 调用 了 ConvertHelper 类 的 GetMapPolyline 方法 ， 来 实现 转换 功能 。 
在 App Code 文件 夹 中 新 增加 一 C# 类 ， 命 名 为 ConvertHelper. 
在 该 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web.Geometry; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls; 


然后 加 入 转换 线 的 GetMapPolyline 方法 。 代 码 如 下 : 


public static ESRI.ArcGIS.ADF.Web.Geometry.Polyline GetMapPolyline( 
Map map, VectorEventArgs polyArgs) { 
System.Drawing.Point[] screenpoly - polyArgs.Vectors; 
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PointCollection pc = new ESRI.ArcGIS.ADF.Web.Geometry.PointCollection(); 
foreach (System.Drawing.Point dpnt in screenpoly) ( 
pc.Add(Point.ToMapPoint (dpnt, map.Extent, 
(int)map.Width.Value, (int)map.Height.Value)); 


Path adf path = new Path(); 

adf path.Points = pc; 

PathCollection adf paths = new PathCollection(); 
adf paths.Add(adf path); 

Polyline mapPoly = new Polyline(); 
mapPoly.Paths = adf paths; 

return mapPoly; 
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回 到 LineBuffer 类 的 ServerAction 方法 中 ， 然 后 利用 如 下 代码 将 Web ADF 的 线 对 象 转换 
73 ArcGIS Server 的 线 对 象 : 


ESRI.ArcGIS.ADF.ArcGISServer.PolylineN ags map polyline; 
ags map polyline = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.FromAdfGeometry ( 
mapPoly) as ESRI.ArcGIS.ADF.ArcGISServer.PolylineN; 


由 于 缓冲 区 分 析 需 要 使 用 的 是 COM 对 象 ， 因 此 需要 先 得 到 服务 器 上 下 文 对象 。 代 码 如 下 : 


MapFunctionality mf; 
mf = (MapFunctionality)map.GetFunctionality ("USAMap") ; 
if (mf == null) 
return; 
MapResourceLocal mrl; 
mrl = (MapResourceLocal)mf.MapResource; 
ESRI.ArcGIS.Server.IServerContext serverContext = 
mrl.ServerContextInfo.ServerContext; 


得 到 服务 器 上 下 文 对 象 后 ， 便 可 以 调用 BufferHelper 类 的 Buffer 方法 ， 对 线 对 象 进行 缓冲 
区 分 析 。 代 码 如 下 : 


ESRI .ArcGIS.Geometry.IPolygon iBufferpolygon = 
BufferHelper.Buffer (serverContext, ags map polyline); 


然后 需要 实现 的 是 根据 该 缓冲 区 多 边 形 , 对 美国 各 县 进行 空间 查询 , 得 到 与 该 多 边 形 相交 的 要 
素 。 代 码 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonN[] queryResults = 
BufferHelper.Query(serverContext, bufferpolygon); 


下 面 要 完成 的 工作 就 是 显示 这 些 几何 图 形 对 象 。 代 码 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.MapDescription mapDescription = 
mf.MapDescription; 

ESRI.ArcGIS.ADF.ArcGISServer.GraphicElement[] ges; 

ges - 
new ESRI.ArcGIS.ADF.ArcGISServer.GraphicElement[2 * queryResults.Length]; 


ESRI.ArcGIS.ADF.ArcGISServer.SimpleFillSymbol querySym = 
AdfHelper.CreateSolidFillSymbol(255, 0, 0); 


for (int i = 0; i < queryResults.Length; i++) ( 
ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement queryPolygon; 
queryPolygon = new ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement () ; 
queryPolygon.Symbol = querySym; 
queryPolygon.Polygon - queryResults[il; 
ges[i] = queryPolygon; 
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ESRI.ArcGIS.ADF.ArcGISServer.LineSymbol lnSymbol = null; 
lnSymbol = new ESRI.ArcGIS.ADF.ArcGISServer.SimpleLineSymbol(); 
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lnSymbol.Color = AdfHelper.CreateColor(0, 0, 0); 
lnSymbol.Width iig 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonN buffer polyn; 
buffer polyn = ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.Com 


ObjectToValueObject (iBufferpolygon, serverContext,typeof (ESRI.ArcGIS.ADF.ArcGIS 
Server.PolygonN)) as ESRI.ArcGIS.ADF.ArcGISServer.PolygonN; 


ESRI.ArcGIS.ADF.ArcGISServer.SimpleFillSymbol bufferSym = 
AdfHelper.CreateFillSymbol(255, 255, 0, lnSymbol); 

ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement bufferPolyElement; 

bufferPolyElement = new ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement(); 

bufferPolyElement.Symbol = bufferSym; 

bufferPolyElement.Polygon - buffer polyn; 


ESRI.ArcGIS.ADF.ArcGISServer.LineElement drawPolyElement; 
drawPolyElement = new ESRI.ArcGIS.ADF.ArcGISServer.LineElement (); 
drawPolyElement.Symbol = lnSymbol; 

drawPolyElement.Line - ags map polyline; 


ges[queryResults.Length] - bufferPolyElement; 
ges[queryResults.Length + 1] = drawPolyElement; 


mapDescription.CustomGraphics - ges; 
// 刷新 地 图 
map.Refresh(); 


编译 并 运行 程序 ， 通 过 线 缓冲 区 工具 , 在 地 图 上 绘制 一 条 线 ， 双 击 结束 画 线 ， 便 可 在 地 图 上 显 


示 该 线 缓冲 区 以 及 该 缓冲 区 影响 的 县 。 效 果 如 图 7.16 所 示 。 
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3. 多边形 缓冲 区 分 析 


在 App Code 文件 夹 中 新 增加 一 C435, 404473 PolygonBuffer. 
在 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 
using ESRI.ArcGIS.ADF.Web.Geometry; 

using ESRI.ArcGIS.ADF.Web.UI.WebControls; 


using ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools; 
using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 


修改 类 的 声明 代码 ， 增 加 对 IMapServerToolAction 接口 的 支持 。 代 码 如 下 : 


public class PolygonBuffer: IMapServerToolAction 


利用 集成 开发 环境 的 代码 自动 生成 功能 ， 创 建 IMapServerToolAction 接口 的 实现 框架 。 
首先 需要 将 屏幕 坐标 的 多 边 形 转换 为 地 图 坐标 的 多 边 形 ， 代 码 如 下 : 
Map map = args.Control as Map; 


PolygonEventArgs polyArgs - (PolygonEventArgs)args; 
Polygon mapPoly - ConvertHelper.GetMapPolygon (map, polyArgs); 


上 述 代 码 调用 了 ConvertHelper 类 的 GetMapPolygon 方法 ， 来 实现 转换 功能 。 该 方法 的 代 
码 如 下 : 
public static ESRI.ArcGIS.ADF.Web.Geometry.Polygon GetMapPolygon (Map map, 


PolygonEventArgs polyArgs) { 
System.Drawing.Point[] screenpoly - polyArgs.Vectors; 


PointCollection pc = new ESRI.ArcGIS.ADF.Web.Geometry.PointCollection(); 
foreach (System.Drawing.Point dpnt in screenpoly) ( 
pc.Add(Point.ToMapPoint (dpnt, map.Extent, 
(int)map.Width.Value, (int)map.Height.Value)); 


Ring ring - new Ring(); 

ring.Points = pc; 

RingCollection rings - new RingCollection(); 
rings.Add (ring); 

Polygon mapPoly - new Polygon(); 
mapPoly.Rings - rings; 

return mapPoly; 


) 


回 到 PolygonBuffer 类 的 ServerAction 方法 中 , 然后 利用 如 下 代码 将 Web ADF 的 多 边 形 对 
象 转换 为 ArcGIS Server 的 多 边 形 对 象 : 
ESRI.ArcGIS.ADF.ArcGISServer.PolygonN ags map polygon; 
ags map polygon = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.FromAdfGeometry ( 
mapPoly) as ESRI.ArcGIS.ADF.ArcGISServer.PolygonN; 


由 于 缓冲 区 分 析 需 要 使 用 的 是 COM 对 象 ， 因 此 需要 先 得 到 服务 器 上 下 文 对 象 。 代 码 如 下 : 
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MapFunctionality mf; 
mf = (MapFunctionality)map.GetFunctionality ("USAMap") ; 
if (mf == null) 
return; 
MapResourceLocal mrl; 
mrl = (MapResourceLocal)mf.MapResource; 
ESRI.ArcGIS.Server.IServerContext serverContext = 
mrl.ServerContextInfo.ServerContext; 


得 到 服务 器 上 下 文 对 象 后 ， 便 可 以 调用 BufferHelper 类 的 Buffer 方法 ， 对 线 对 象 进 行 缓冲 


区 分 析 。 代 码 如 下 : 


ESRI.ArcGIS.Geometry.IPolygon iBufferpolygon = 
BufferHelper.Buffer(serverContext, ags map polygon); 


然后 需要 实现 的 是 根据 该 缓冲 区 多 边 形 , 对 美国 各 县 进行 空间 查询 , 得 到 与 该 多 边 形 相交 的 要 
代码 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonN[] queryResults = 
BufferHelper.Query(serverContext, bufferpolygon); 


下 面 要 完成 的 工作 就 是 显示 这 些 几何 图 形 对 象 。 代 码 如 下 : 


ESRI.ArcGIS.ADF.ArcGISServer.MapDescription mapDescription = 
mf.MapDescription; 

ESRI.ArcGIS.ADF.ArcGISServer.GraphicElement[] ges; 

ges = 
new ESRI.ArcGIS.ADF.ArcGISServer.GraphicElement [2 * queryResults.Length]; 


ESRI.ArcGIS.ADF.ArcGISServer.SimpleFillSymbol querySym = 
AdfHelper.CreateSolidFillSymbol(255, 0, 0); 


for (int i = 0; i < queryResults.Length; i++) ( 
ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement queryPolygon; 
queryPolygon = new ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement (); 
queryPolygon.Symbol = querySym; 
queryPolygon.Polygon = queryResults[i]; 
ges[i] = queryPolygon; 


ESRI.ArcGIS.ADF.ArcGISServer.LineSymbol lnSymbol = null; 

lnSymbol = new ESRI.ArcGIS.ADF.ArcGISServer.SimpleLineSymbol(); 

lnSymbol.Color AdfHelper.CreateColor(0, 0, 0); 

lnSymbol.Width 1; 

ESRI.ArcGIS.ADF.ArcGISServer.SimpleFillSymbol sfsl = 
AdfHelper.CreateFillSymbol(255, 255, 0, l1nSymbol); 

ESRI.ArcGIS.ADF.ArcGISServer.PolygonN buffer polyn; 

buffer polyn = ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.Com 


上 


上 


ObjectToValueObject (iBufferpolygon, serverContext,typeof (ESRI.ArcGIS.ADF.ArcGIS 


Server.PolygonN)) as ESRI.ArcGIS.ADF.ArcGISServer.PolygonN; 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement bufferPolyElement; 
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bufferPolyElement = new ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement () ; 
bufferPolyElement.Symbol = sfs1; 
bufferPolyElement.Polygon = buffer polyn; 


ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement drawPolyElement; 
drawPolyElement = new ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement () ; 
drawPolyElement.Symbol = sfs1; 

drawPolyElement.Polygon = ags map polygon; 


ges[queryResults.Length] = drawPolyElement; 
ges[queryResults.Length + 1] = bufferPolyElement; 


mapDescription.CustomGraphics - ges; 
// 刷新 地 图 
map.Refresh(); 
编译 并 运行 程序 ， 通 过 线 缓冲 区 工具 , 在 地 图 上 绘制 一 多 边 形 ， 双 击 结束 画 多 边 形 ， 便 可 在 地 
图 上 显示 该 多 边 形 缓冲 区 以 及 该 缓冲 区 影响 的 县 。 效 果 如 图 7.17 所 示 。 
Æ Untitled Page - Kicrosoft Internet Explorer 


XO REO FEV KEW IAW WR50D 
HBE M) (Æ) http: //1ocalhost/Bu£ferAnalysi s/ 


日 回 USAMap 
shigh 


E counties 


—. 


< s mt 


Æ) Polygon - Click to start line. Click again to add vectors XJ 本 地 Intranet 


图 7.17 多 边 形 缓冲 区 分 析 
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在 ESRI 产品 的 许多 层次 都 存在 任务 的 概念 。 任 务 就 是 提供 公共 结果 的 一 组 相关 动作 。 
例如 ArcGIS Server 空间 处 理 服务 ， 就 是 在 GIS 服务 器 执行 空间 分 析 的 服务 器 任务 。 

Web ADF 提供 了 一 个 任务 框架 ， 用 于 创建 、 集 成 与 分 发 组 件 ( 或 称 为 Web 任务 ) 。 实 
Web. Web 任务 就 是 一 ASP.NET 的 Web 控件 , 该 控件 使 用 并 扩展 了 Web ADF 任务 框架 , 在 
可 分 发 的 组 件 中 封装 了 自 定义 功能 。 任 务 框架 包含 了 一 组 创建 自 定义 任务 的 接口 与 抽象 类 ， 
一 组 支持 任务 管理 与 显示 结果 的 控件 ， 以 及 可 集成 到 Visual Stuido 与 ArcGIS Manager 中 的 功 
能 。 此 外 ，Web ADF 中 提供 了 现存 的 任务 控件 ， 用 于 支持 在 Web 应 用 程序 常用 的 GIS 功能 。 

通过 本 章 你 将 了 解 到 : 


8.1 任务 控件 
82 自 定义 任务 
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任务 框架 中 包含 了 用 于 任务 管理 与 接口 显示 的 控件 ， 例 如 TaskManager 与 TaskResults， 还 包 
含 了 一 组 任务 控件 ， 例 如 SearchAttributesTask, QueryAttributesTask, FindPlaceTask 等 。 


8.1.1 任务 支持 控件 


任务 支持 控件 包括 TaskManager 与 TaskResults。 

TaskManager 控件 用 于 在 Web 应 用 程序 中 组 织 与 管理 任务 。TaskManager 控件 生成 XML 结构 
的 数据 ， 这 些 数据 可 以 在 ASPNET 的 导航 控件 中 使 用 ， 例 如 Menu 与 TreeView 控件 。 在 程序 运行 
期 间 ，ASP.NET 的 Menu 或 TreeView 控件 的 节点 可 用 于 显示 任务 的 浮动 面板 。 因 此 该 控件 只 在 程 
序 设 计 期 间 可 见 。 

TaskResults 控件 用 于 存储 任务 的 结果 。 该 结果 可 以 用 TreeView 控件 的 节点 来 显示 。TaskResults 
控件 也 支持 要 素 的 放大 、 缩 小 与 漫游 、 高 亮 显 示 结 果 集中 的 某 一 要 素 、 重 新 执行 某 任务 以 及 删除 任 
务 结果 。 

虽然 并 不 一 定 需要 在 Web 应 用 程序 中 使 用 任务 支持 控件 ， 但 通常 可 利用 任务 支持 控件 来 提升 
Web 任务 用 户 体验 。 


8.1.2 Web ADF 提供 的 任务 控件 


Web ADF 提供 了 一 组 任务 控件 ， 这 些 控件 实现 并 扩展 了 任务 框架 ,可 以 完全 集成 到 Web 应 用 
程序 。 

使 用 SearchAttributesTask 控件 ， 可 根据 用 户 输入 的 值 ， 从 资源 中 查询 一 组 字段 。 在 运行 期 间 ， 
查询 每 个 字段 ,看 是 否 包含 用 户 提供 的 值 ,不 过 仅仅 支持 地 图 资源 管理 器 中 包含 的 资源 的 要 素 图 层 。 
查询 结果 的 类 型 是 ADO.NET 的 DataSet， 并 显示 在 一 TaskResults 控件 中 。 

通过 QueryAttributesTask 控件, 则 可 指定 某 字段 的 查询 参数 ,该 控件 提升 了 SearchAttributesTask 
控件 的 基本 查询 功能 。 在 运行 期 间 ， 一 个 QueryAttributesTask 查询 可 提供 一 下 拉 列 表 框 用 于 选择 ， 
或 提供 一 文本 框 用 于 用 户 输入 文本 。 每 个 查询 可 利用 有 效 检查 器 来 限制 输入 的 值 , 也 可 以 将 几 个 查 
询 组 合 在 一 块 ， 得 到 一 个 结果 。 同样， 该 控件 只 支持 地 图 资源 管理 器 中 包含 的 资源 的 要 素 图 层 。 查 
询 结果 的 类 型 也 是 ADONET 的 DataSet， 并 显示 在 TaskResults 控件 中 。 

另外 ，FindPlaceTask 控件 用 于 包含 地 名 查询 图 层 的 ArcWeb 服务 。 该 控件 包含 一 个 用 于 输入 
地 名 的 文本 框 。 查 询 结果 的 类 型 是 ADONET 的 DataSet， 并 显示 在 TaskResults 控件 中 。 

FindAddressTask 控件 使 用 地 理 编码 资源 管理 器 中 的 资源 执行 地 址 匹配 操作 。 该 控件 将 依据 使 
用 的 资源 ,动态 创建 运行 期 间 的 界面 .查询 结果 的 类 型 是 ADO.NET H DataSet, 并 显示 在 TaskResults 
控件 中 。 

GeoprocessingTask 控件 使 用 空间 处 理 资源 管理 器 中 的 资源 ， 执 行 空间 处 理 任务 。 该 控件 将 依 
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据 空间 处 理 资源 要 求 的 输入 条 件 以 及 使 用 的 任务 ， 动 态 创建 运行 期 间 的 界面 。 查 询 结果 的 类 型 是 
ADO.NET 的 DataSet， 并 显示 在 一 TaskResults 控件 中 。 

EditorTask 控件 为 Web 应 用 程序 提供 一 组 编辑 要 素 的 功能 。 运 行 期 间 提供 一 对 话 框 来 修改 、 
增加 与 删除 要 素 的 几何 图 形 与 属性 信息 。 


8.1.3 任务 框架 的 构成 


图 8.1 显示 了 任务 框架 中 包含 的 类 与 接口 。 


TaskDesigner CustomTask 
Designer 


Floating IWebConfigurator 
PanelTask 


CustomTask 
WebConfigurator. 


CustomTask ITaskResultsContainer 
P Custom 
TaskResults ! TaskResults 


Required Optional 
图 8.1 任务 框架 包含 的 类 与 接口 


通常 ，Task 与 FloatingPanelTask 抽象 类 只 实现 了 ITask 接口 中 的 基本 方法 。 程序 员 可 以 根据 任 
务 的 需求 ， 必 须 继承 这 两 个 抽象 类 之 一 ， 创 建 自 定义 任务 。 但 是 ,为 了 与 其 他 Web ADF 组 件 集成 ， 
程序 员 可 以 选择 自 定义 其 他 任务 组 件 。TaskDesigner 类 人 允许 程序 员 自 定 义 程序 设计 期 间 的 界面 。 
IWebConfigurator 接口 定义 了 如 何 将 自 定义 任务 集成 到 Manager 应 用 程序 中 。 这 样 在 使 用 Manager 
创建 Web 应 用 程序 时 ， 便 可 选择 该 自 定 义 的 任务 。ITaskResultsContainer 接口 运行 程序 员 开 发 一 自 
定义 的 用 户 控件 来 显示 任务 结果 。 

任务 框架 中 的 核心 接口 是 ITask, 位 于 ESRIArcGIS.ADF.Web.UI.WebControls 命名 空间 中 。 所 
有 的 任务 必须 实现 ITask 接口 。 该 接口 的 定义 如 下 : 


namespace ESRI.ArcGIS.ADF.Web.UI.WebControls { 
public interface ITask { 

string ShowUrl { get;} 
string Title { get; set;} 
string ToolTip { get;set;} 
string NavigationPath { get; set;} 
BuddyControlCollection TaskResultsContainers { get;} 
object Results { get;set;] 
void ExecuteTask():; 
string TaskActivityIndicatorText ( get;] 
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bool GroupResultsByTable ( get;set;] 
bool ShowFieldAttributes { get;set;] 
bool ShowLegend { get; set;} 


object Input ( get; set;} 

void Refresh(); 

void Show(); 

CallbackResultCollection CallbackResults { get;} 


string UniqueID ( get;] 
List«GISResourceltemDependency» GetGISResourceItemDependencies (); 


) 


Task 与 FloatingPanelTask 两 个 抽象 类 已 经 实现 了 ITask 接口 中 最 基础 的 功能 ,用 户 自 定 义 任务 
时 ， 可 以 从 这 两 个 类 继承 ， 作 为 起 点 。 这 两 个 类 的 最 大 不 同 在 于 : 继承 于 Task 的 任务 不 能 包含 在 
FloatingPanel 控件 中 ， 继 承 于 FloatingPanelTask 的 任务 在 运行 期 间 包 含 在 一 FloatingPanel 控件 中 。 

本 质 上 任务 就 是 一 ASPNET 组 合 控件 。 因 此 ，Task 与 FloatingPanelTask 都 继承 于 
System.Web.ULWebControls.CompositeControl， 如 图 8.2 所 示 。 由 于 CompositeControl 实现 了 
ICallbackEventHandler 接口 ， 因 此 可 以 在 ASPNET 的 Web 应 用 程序 中 应 用 AJAX 功能 。 
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图 8.2 自 定义 任务 需要 继承 的 类 


IBuddyControlSupport 接口 定义 了 方法 GetSupportedBuddyControlTypes， 来 说 明 任务 绑 定 的 空 
间 类 型 。 如 OverviewMap 控件 绑 定 Map, Toolbar 控件 绑 定 Map 以 及 PageLayout 控件 。Task 与 
FloatingPanelTask 类 定义 了 任务 能 连接 控件 的 类 型 。 我 们 如 果 对 Map 操作 ， 则 可 以 使 用 如 下 代码 : 

public Type[] GetSupportedBuddyControlTypes() { 


return new Type[] { typeof(Map) }; 
} 
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由 于 使 用 Web ADF 提供 的 任务 控件 方法 很 简单 ， 并 且 已 经 在 4.1.2 节 中 简单 做 了 介绍 ， 因 此 
我 们 不 准备 再 详细 介绍 这 些 任务 控件 的 使 用 。 而 是 通过 一 个 自 定义 任务 的 实例 , 来 介绍 整个 任务 框 
架 。 
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本 实例 的 任务 在 运行 期 间 , 包含 一 浮动 面板 ， 面 板 中 包含 一 个 按钮 与 一 文本 框 。 用 户 在 文本 杠 
中 输入 ,然后 选择 按钮 ， 应 用 程序 将 根据 文本 框 中 的 内 容 进行 查询 ， 并 将 结果 显示 在 任务 结果 控件 


中 。 


82.1 自 定义 任务 类 库 


新 建 一 Class Library 类 型 的 工程 ， 将 工程 名 称 设 置 为 QueryTask， 解 决 方案 名 称 命名 为 
CustomTask. 

在 工程 中 加 入 System Web.dll 、  System.Drawing.dll 、 ESRLArcGIS.ADF. Web dll 、 
ESRLArcGIS.ADF.Web.DataSource.dll 与 ESRIArcGIS.ADF.Web.UI. WebControls.dll 几 个 类 库 的 引 
用 。 

将 默认 加 入 的 Classl.cs 文件 重新 命名 为 SimpleQueryTask.cs。 集成 开发 环境 会 自动 将 类 名 转换 
JJ SimpleQueryTask. 

在 该 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 

using System.Web.UI; 

using System.Drawing; 

using System.Web.UI.WebControls; 

using System.Web.UI.HtmlControls; 

using System.Collections.Specialized; 

using ESRI.ArcGIS.ADF.Web.UI.WebControls; 

using System.ComponentModel; 

using System.Drawing.Design; 

由 于 需要 一 个 用 户 输入 查询 条 件 的 界面 ， 因 此 本 自 定义 任务 应 该 继承 FloatPanelTask 类 。 
将 SimpleQueryTask 的 声明 代码 修改 为 如 下 : 

[ToolboxData ("«(0) :SimpleQueryTask runat=\"server\" Width=\"100px\" 
BorderWidth=\"1px\"> </{0}:SimpleQueryTask>")] 

public class SimpleQueryTask : FloatingPanelTask 

在 上 面 的 代码 中 , 除了 声明 类 的 继承 关系 外 , 还 利用 ToolboxData 属性 类 , 指定 当 从 Microsoft 
Visual Studio 等 工具 中 的 工具 箱 拖 动 自 定义 控件 时 为 它 生 成 的 默认 标记 。 而 其 中 出 现 的 所 有 {0} 都 
将 由 设计 器 替换 为 与 simpleQueryTask 类 关联 的 标记 前 级 。 

接着 在 类 中 加 入 一 些 字 段 ， 用 于 在 运行 期 间 引 用 其 中 的 控件 : 

private TextBox textBox = null; 

private TextBox phantomTextBox = null; 

private HtmlInputButton button - null; 

然后 加 入 两 个 属性 ，ButtonText 与 Map. ButtonText 表示 查询 按钮 显示 的 文本 信息 ， 而 Map 
表示 要 查询 的 地 图 的 ID。 代码 如 下 : 

[Browsable (true)] 


[Category ("Appearance")] 
[DefaultValue ("查询 ")] 


[ae 
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[PersistenceMode (PersistenceMode.Attribute)] 
public string ButtonText { 


get { 
object o = StateManager.GetProperty ("buttonText"); 
return (o == null) ? "Execute" : o as string; 

) 

set { 


StateManager.SetProperty("buttonText", value); 


/// «summary» 

/// 要 查询 的 地 图 的 ID 

/// </summary> 

[Browsable (true)] 

[Category ("SimpleQueryTask")] 

[DefaultValue ("Map1")] 

[Description(" 要 查询 的 地 图 的 ID， 如 果 为 空 ， 则 使 用 第 一 个 地 图 控件 。") ] 
[PersistenceMode (PersistenceMode.Attribute)] 

public string Map ( 


get ( 
object o = StateManager.GetProperty ("map") ; 
return (o == null) ? "Mapl" : o as string; 
) 
set { 


StateManager.SetProperty("map", value); 


) 


Pimi CEFR) 父 类 的 CreateChildControls 方法 。 该 方法 在 运行 期 间 创建 任务 的 可 视界 面 , 因此 ， 
输出 结果 必须 可 在 浏览 器 中 使 用 。 该 过 程 必须 通过 程序 代码 来 实现 ， 可 使 用 NET 的 HTML 控件 类 
或 ASPNET 控件 的 内 容 ， 来 创建 该 界面 。 代 码 如 下 : 


protected override void CreateChildControls() { 
Controls.Clear (); 
base.CreateChildControls(); 


textBox - new TextBox(); 
textBox.ID = "textBox"; 


phantomTextBox - new TextBox(); 
phantomTextBox.ID = "phantomTextBox"; 
phantomTextBox.Style[HtmlTextWriterStyle.Display] = "none"; 


button = new HtmlInputButton(); 
button.ID = "button"; 
button.Value = ButtonText; 


Controls.Add (textBox); 
Controls.Add (phantomTextBox); 
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Controls.Add (button); 


string formateStr = 
"'textBoxValue-' + document.getElementById('(0]').value"; 
string getArgumentJUS = string.Format(formateStr, textBox.ClientID); 
string onClick = string.Format ("executeTask((0), V" (1) V") ;", 
getArgumentJS, 
CallbackFunctionString); 
string onKeyDown = string.Format( 

"if(event.keyCode--13)(((0) return false;]]", onClick); 
button.Attributes.Add("onclick", onClick); 
textBox.Attributes.Add("onkeydown", onKeyDown); 

) 


在 上 述 代码 中 ， 创 建 了 包含 两 个 单元 格 的 HTML 表格 。 其 中 一 个 单元 格 中 包含 一 个 文本 框 ， 
另 一 个 单元 格 包含 一 按钮 。 

履 盖 父 类 的 GetCallbackResult 方法 ， 在 运行 期 间 将 Input 属性 设置 为 任务 提交 的 值 。Input 属 
性 是 在 FloatingPanelTask 类 中 定义 的 。 该 属性 的 类 型 是 object， 但 是 通常 仅仅 就 是 一 字符 串 。 我 们 
将 在 ExecuteTask 方法 中 使 用 该 属性 。 代 码 如 下 : 


public override string GetCallbackResult () 
il 
NameValueCollection keyValColl = 
CallbackUtility.ParseStringIntoNameValueCollection( callbackArg); 
Input = keyValColl["textBoxValue"]; 
return base.GetCallbackResult(); 
) 


下 面 要 实现 的 就 是 增加 自 定义 任务 的 执行 。 代 码 如 下 : 


public override void ExecuteTask() { 
Results = null; 
if (Input == null) 
return; 


string textBoxValue = Input as string; 


Map mapCtrl = (Map)Utilities.FindControlRecursive (Page, this.Map); 
System.Data.DataSet ds = Utilities.AttributeQuery (mapCtrl, textBoxValue); 


Results - ds; 

} 

在 上 面 的 代码 中 ， 通 过 Input 属性 ， 得 到 用 户 在 文本 框 输入 的 查询 条 件 ， 然 后 调用 Utilities 类 
的 静态 AttributeQuery 方法 执行 查询 。 在 调用 该 方法 之 前 ， 调 用 了 Utilities 类 的 静态 
FindControlRecursive 方法 ， 从 页 面 中 查找 到 指定 ID 的 地 图 控件 。ExecuteTask 方法 的 代码 最 后 将 
查询 结果 赋 给 Results 属性 。 该 属性 的 内 容 将 显示 在 TaskResults 控件 中 。TaskResults 类 的 
DisplayResult 方法 负责 处 理 Results 对 象 。 该 对 象 的 类 型 可 以 是 System.Data DataSet 、 
ESRI.ArcGIS.ADF.Web.UI.WebControls.TaskResultNode 或 ESRLArcGIS.ADF.Web.UI. 
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覆盖 父 类 的 Refresh 方法 。 在 运行 期 间 处 理 在 TaskResults 控件 中 ， 重 新 运行 任务 与 刷新 任务 。 
代码 如 下 : 


public override void Refresh() { 
string tmp = Input as string; 
if (!string.IsNullOrEmpty (tmp)) 
textBox.Text = tmp; 
base.Refresh(); 


) 


为 完成 自 定义 任务 ， 还 需要 履 盖 父 类 的 GetGISResourceltemDependencies 方法 ， 该 方法 用 于 维 
护 相 关 资 源 项 集合 。 


public override List«GISResourceItemDependency» 

GetGISResourceItemDependencies() ( 
List«GISResourceItemDependency»? list = new List«GISResourceItemDependency» (); 
return list; 


} 
在 当前 工程 中 新 增加 名 为 Utilities 的 C# 类 。 在 其 头 部 加 入 如 下 命名 空间 的 引用 : 


using System.Web.UI; 

using System.Web.UI.WebControls; 

using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.Web.DataSources; 
using ESRI.ArcGIS.ADF.Web; 


FindControlRecursive 静态 方法 的 代码 如 下 ， 用 于 从 指定 控件 中 循环 寻找 指定 ID 的 子 控件 : 


public static Control FindControlRecursive (Control root, string id) ( 
if (root.ID == id) ( 
return root; 


) 


foreach (Control c in root.Controls) ( 
Control t - FindControlRecursive(c, id); 
HEU nu 

return t; 

} 

} 


return null; 


} 


执行 查询 的 AttributeQuery 方法 的 代码 如 下 。 为 了 方便 起 见 ， 我 们 直接 在 代码 中 指定 查询 
NorthAmericaMap 资源 的 3 号 图 层 ， 即 美国 州 行政 区 划 图 层 。 


public static System.Data.DataSet AttributeQuery (Map map, string condition) 
t 

IGISFunctionality gisfunc = map.GetFunctionality ("NorthAmericaMap"); 

if (gisfunc -- null) 
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return null; 


IGISResource gisresource = gisfunc.Resource; 
bool supportquery = 
gisresource.SupportsFunctionality (typeof (IQueryFunctionality)); 
if (!supportquery) 
return null; 


IQueryFunctionality qfunc; 
qfunc = gisresource.CreateFunctionality (typeof (IQueryFunctionality), null) 


as IQueryFunctionality; 


) 


SpatialFilter spatialfilter - new SpatialFilter(); 
spatialfilter.ReturnADFGeometries = false; 
spatialfilter.MaxRecords - 1000; 
spatialfilter.WhereClause - condition; 


System.Data.DataTable datatable = qfunc.Query(null, "3", spatialfilter); 
if (datatable == null) 
return null; 


System.Data.DataSet ds = new System.Data.DataSet(); 
ds.Tables.Add(datatable); 
return ds; 


为 了 准备 控件 分 发 ， 需 要 为 该 任务 指定 一 标记 前 级 。 通 常 ， 该 信息 存储 在 AssemblyInfo.cs X 
件 中 。TagPrefix 属性 定义 在 网 页 中 用 于 标识 自 定义 控件 的 标记 前 级 。 
打开 工程 中 Properties 文件 夹 下 的 AssemblyInfo.cs 文件 ， 先 加 入 如 下 命名 空间 的 引用 : 


using System.Web.UI; 

然后 在 该 文件 的 最 后 加 入 如 下 代码 ， 指 定 一 标记 前 绥 : 
[assembly: TagPrefix("QueryTask", "queryTask")] 

这 样 我 们 便 初 步 完 成 了 一 个 自 定义 任务 。 编 译 该 自 定义 任务 类 库 。 


822 应 用 自 定义 的 任务 


通过 Visual Studio 2005 的 File 菜单 的 Add New Web Site 命令 ， 在 当前 解决 方案 中 新 增加 一 个 
站 点 ， 命 名 为 CustomTaskTest。 

在 Default.aspx 页 面 中 加 入 一 地 图 资源 管理 器 控件 、 一 地 图 控件 、 一 任务 管理 器 控件 与 一 任务 
结果 控件 。 在 地 图 资源 管理 器 中 加 入 NorthAmericaMap 资源 。 

然后 在 工具 箱 中 选择 右键 菜单 的 Choose Items 命令 ， 打 开 Choose Toolbox Items 对 话 框 。 该 对 
话 框 中 ， 选 择 Browse 按钮 ， 选 择 8.2.1 节 创 建 的 QueryTask.dll 接口 。 选 择 OK 保存 设置 。 这 时 就 
会 在 工具 箱 中 显示 我 们 自 定义 的 任务 控件 。 将 该 控件 拖 到 任务 管理 器 控件 中 。 
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将 自 定义 任务 控件 的 相关 控件 设置 为 任务 结果 控件 。 

编译 并 运行 程序 ， 在 自 定义 任务 界面 中 输入 查询 条 件 ， 选 择 “查询 ”后 ， 便 可 得 到 查询 结果 。 
运行 效果 如 图 8.2 所 示 。 


自 定义 查询 “四 


STATE NAME LIKE 'S%| 


S NewDataSet 
S 回 States 
@ C South Dakota. 
& [South Carolina 
AREA 30867.3986 
STATE NAME South Carolina 


POP1990 ^ 3486703 
POP1999 ^ 3885798 


82 自 定义 任务 运行 效果 
823 ”任务 运行 流程 


在 应 用 程序 运行 期 间 ， 大 多 数 的 任务 遵循 标准 的 流程 ， 先 处 理 用 户 请 求 ， 并 生成 与 显示 结果 。 
Web ADF 的 JavaScript, Web ADF 控件 类 、 任 务 框架 接口 及 其 实现 共同 支撑 任务 的 工作 。 图 8.3 
演示 了 本 实例 运行 流程 步骤 。 


senpt> FloatingPanelTask 
ede ask <serph> is 
em TaskControi 


display dotnetadfjs 
P: 
p -— | 二 一 一 


83 ”本 实例 自 定义 任务 运行 流程 
本 实例 自 定义 任务 运行 流程 步骤 如 下 : 
COD 用 户 在 浏览 器 中 单 击 按钮 查询 时 ， 应 用 程序 调用 Web ADF JavaScript display task.js 文件 
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的 executeTask 函数 。 任 务 控件 定义 了 用 户 动作 。executeTask 函数 中 两 个 最 重要 的 参数 分 别 是 回调 
参数 与 回调 函数 字符 串 。 回 调 参数 提供 了 用 户 操作 的 信息 , 例如 提供 查询 数据 库 的 字符 串 。 回 调 函 
数字 符 串 定义 了 ASP.NET 回调 管理 器 函数 的 内 容 ， 即 WebForm_DoCallback。 读 者 可 以 通过 网 页 
右键 菜单 的 “查看 源 文件 ”命令 ， 查 看 按钮 的 onclick 事件 响应 函数 的 代码 ， 基 本 如 下 : 

onclick-"executeTask('textBoxValue-'-*document.getElementById ('TaskManager1 
 .SimpleQueryTaskl textBox').value',"WebForm DoCallback('TaskManagerl$ SimpleQu 
eryTaskl, argument, processCallbackResult, context, postBackError, true)");" 

executeTask 函数 在 执行 任务 之 前 ， 完 成 两 个 工作 ， 一 是 为 异步 请 求 指定 一 任务 ID， 另 一 个 是 
初始 化 一 回调 ， 启 动 在 任务 结果 控件 中 的 正在 执行 状态 显示 器 。 然 后 调用 startJob 函数 处 理 用 户 的 
输入 。 

(2) startJob 函数 创建 任务 处 理 用 户 请 求 需要 的 参数 。 任 务 控件 使 用 EventArg 参数 来 确定 是 

否 应 该 执行 以 及 提供 结果 。 自 定义 参数 提供 了 用 户 在 文本 框 输入 的 信息 。 这 些 值 打 包 为 一 个 字符 串 ， 
并 传递 给 WebForm_DoCallback 函数 的 argument 参数 。 例 如 在 本 实例 中 ， 使 用 的 都 是 如 下 的 参数 ， 
其 中 textBoxValue 段 是 自 定义 参数 : 


"EventArg-executeTask&taskJobID-2&textBoxValue-STATE NAME LIKE 'S$'" 


WebForm DocCallback 函数 中 第 一 个 参数 表示 处 理 回调 请 求 的 控件 的 名 称 ， 在 本 实例 中 ， 该 名 
称 应 该 为 任务 控件 运行 期 间 的 名 称 。 在 Web 端 XMLHttpRequest 对 象 初始 化 该 回调 ， 并 将 内 容 传 
递 给 任务 控件 。 由 于 任务 控件 继承 于 FloatingPanelTask， 所 以 RaiseCallbackEvent 方法 将 捕捉 到 该 
参数 ， 并 保存 在 _callbackArg 成 员 变 量 中 。 在 执行 任务 时 需要 使 用 该 成 员 变 量 。 

G) 在 回调 阶段 ，RaiseCallbackEvent 执行 完成 之 后 ， 将 调用 GetCallbackResult 方法 。 在 任务 
控件 中 ， 利 用 该 方法 从 自 定义 参数 中 获取 用 户 输入 的 值 。 该 值 存储 在 Input 属性 中 。 在 我 们 的 实例 
中 ， 使 用 Web ADF 的 CallbackUtility 类 处 理 _callbackArg 成 员 变量 ， 将 其 处 理 为 “名 称 \ 值 ”对 。 
由 于 只 有 自 定义 参数 ， 即 textBoxValue， 有 用 ， 因 此 将 其 保存 在 Input 属性 中 。 

(4) FloatingPanelTask 类 的 GetCallbackResult 方法 负责 调用 执行 任务 的 方法 ， 以 及 构建 在 浏 
览 器 中 显示 的 回调 响应 字符 串 。 首 先 处 理 _callbackArg 变量 ， 确 定 主要 事件 参数 EventArg. 
FloatingPanelTask 类 寻找 两 个 特定 的 值 ， 分 别 是 startTaskActivityIndicator 与 executeTask。 如 果 是 
startTaskActivityIndicator， 则 在 任务 结果 控件 中 显示 一 正在 执行 显示 器 。 如 果 是 executeTask， 在 调 
用 自 定义 任务 类 中 的 ExecuteTask 方法 ， 然 后 调用 FloatingPanelTask 类 中 的 DisplayResults 方法 ， 
创建 一 回调 字符 串 。GetCallbackResult 方法 的 代码 如 下 : 

public override string GetCallbackResult () 
t 


NameValueCollection keyValColl = 
CallbackUtility.ParseStringIntoNameValueCollection( callbackArg); 


string eventArg = keyValColl["EventArg"]; 
string taskJobID = keyValColl["taskJOobID"]; 


if (eventArg == "startTaskActivityIndicator") { 
StartTaskActivityIndicator (taskJobID); 
) 
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else if (eventArg == "executeTask") { 
ExecuteTask(); 
DisplayResults (taskJobID, Input, Results); 
} 
else { 
return base.GetCallbackResult (); 


} 


return CallbackResults.ToString(); 
) 

C5) 自 定 义 的 任务 类 的 ExecuteTask 方法 是 任务 处 理 任务 的 主体 。 在 这 里 可 以 使 用 Web ADF 
的 控件 、 资 源 、 功 能 以 及 数据 源 特 有 的 API， 处 理 保 存在 Input 属性 中 的 输入 值 。 任 务 执 行 的 结果 
保存 在 名 为 Results 的 属性 中 , 该 属性 中 的 内 容 将 显示 在 任务 结果 控件 中 。 ITask 接口 定义 了 Results 
属性 ， 而 FloatingPanelTask 类 实现 了 该 接口 ， 因 此 自 定义 任务 类 也 有 该 属性 。 该 属性 可 以 是 三 种 类 
型 ， 分 别 是 SimpleTaskResult、DataSet 与 TaskResultNode。 

C6) 然后 调用 FloatingPanelTask 类 的 DisplayResults 方法 。 该 方法 将 Results 属性 对 象 加 入 到 
任务 结果 控件 中 。 任 务 结果 控件 本 身 有 一 个 DisplayResults 方法 ,用 于 在 浏览 器 中 显示 HTML 内 容 。 
Web ADF 控件 使 用 CallbackResult 对 象 更 新 该 控件 中 的 显示 内 容 。 当 服务 器 端 任务 结果 控件 改变 
时 ， 它 创建 一 CallbackResults 集合 ， 而 该 集合 用 于 创建 传递 给 浏览 器 的 回调 响应 。 因 此 ， 需 要 将 任 
务 结果 控件 中 的 CallbackResults 加 入 到 自 定义 任务 控件 的 CallbackResults 属 性 中 。FloatingPanelTask 
控件 的 DisplayResults 方法 的 代码 如 下 : 

protected virtual void DisplayResults (string jobID, object taskInput, object 
taskResults) ( 
ITaskResultsContainer resultsContainer - null; 
for (int i = 0; i < TaskResultsContainers.Count; i++) ( 
resultsContainer = Utility.FindControl(TaskResultsContainers[i].Name, 
Page) 
as ITaskResultsContainer; 
if (resultsContainer !- null) ( 
resultsContainer.DisplayResults (this, jobID, taskInput, 
taskResults); 
CallbackResults.CopyFrom(resultsContainer.CallbackResults); 
) 


(7) 重新 调用 自 定义 任务 控件 的 GetCallbackResult 方法 ， 将 回调 响应 发 送 到 客户 端的 浏览 
中 。 自 定义 任务 控件 使 用 CallbackResults 属性 来 存储 需要 返回 给 浏览 器 的 内 容 字符 串 。Web ADF 
的 JavaScript 函数 处 理 该 字符 串 ， 更 新 浏览 器 中 Web ADF 控件 的 显示 。CallbackResults 属性 存储 
了 CallbackResult 对 象 的 集合 。 

C8) 回调 响应 处 理 函 数 处 理 结果 字符 串 。 在 本 实例 中 ， 使 用 的 是 Web ADF 定义 的 
processCallbackResult 函数 。 该 函数 用 于 解析 回调 响应 ， 更 新 客户 端的 显示 。 

C9) 根据 回调 响应 结果 更 新 浏览 器 中 的 控件 。 在 本 实例 中 ， 用 查询 结果 更 新 任务 结果 控件 。 
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8.2.4 自 定义 任务 的 改进 


为 了 改善 自 定义 任务 控件 在 Visual Studio 设计 期 间 的 属性 的 设置 与 修改 ， 我 们 可 以 继承 
ESRLArcGIS.ADF.Web.UI.WebControls.Design.Designers 命名 空间 中 的 TaskDesigner 或 
ControlTypeEditor。 其 中 ControlTypeEditor 用 于 提供 一 下 拉 列 表 框 ， 让 用 户 选择 其 中 一 个 值 来 设置 
属性 。 

在 QueryTask 工程 中 ， 新 增加 一 个 类 ， 命 名 MapControlEditor。 首 先 加 入 如 下 命名 空间 的 
引用 : 


using ESRI.ArcGIS.ADF.Web.UI.WebControls.Design; 
然后 将 类 的 代码 修改 为 如 下 : 


class MapControlEditor : ControlTypeEditor ( 
protected override void DefineSupportedTypes( 
System.ComponentModel.ITypeDescriptorContext pContext) ( 
ClearSupportedTypes(); 
AddSupportedType (typeof (ESRI.ArcGIS.ADF.Web.UI.WebControls.Map)); 


) 

上 面 的 代码 指定 在 下 拉 列 表 框 中 显示 页 面 中 所 有 地 图 控件 的 名 称 。 

我 们 可 以 通过 .NET 的 属性 (Attribute) 来 应 用 编辑 器 。 

切换 到 SimpleQueryTask.cs 文件 中 ， 在 Map 属性 (Property) 加 入 一 编辑 器 属性 ， 应 用 上 述 继 
IKF ControlTypeEditor 类 的 编辑 器 。Map 属性 的 代码 最 终 如 下 所 示 : 


[Browsable (true) ] 

[Category ("SimpleQueryTask")] 

[DefaultValue ("Map1")] 

[Description(" 要 查询 的 地 图 的 ID， 如 果 为 空 ， 则 使 用 第 一 个 地 图 控件 。") ] 
[Editor (typeof (MapControlEditor), typeof (UITypeEditor))] 
[PersistenceMode (PersistenceMode.Attribute)] 

public string Map ( 


get ( 
object o = StateManager.GetProperty ("map") ; 
return (o == null) ? "Mapl" : o as string; 
) 
set { 


StateManager.SetProperty ("map", value); 
h 
) 
在 上 述 代码 中 ， 我 们 利用 Editor 属性 指定 用 来 更 改 Map 属性 的 编辑 器 为 MapControlEditor。 
重新 编译 QueryTask 工程 。 并 在 CustomTaskTest 工程 中 ， 重 新 加 入 该 自 定义 任务 控件 。 这 时 
在 该 控件 的 属性 编辑 面板 中 ， 就 可 以 通过 下 拉 列 表 框 来 为 Map 属性 设置 值 ， 效 果 如 图 8.4 所 示 。 


SimpleQueryTaskl QueryTask. SimpleQueryTask ~ 


ForeColor LJ 
GroupResultsByTable True 
Height 

HeightResizable 


NavigationPath 
ShowDockButton 
ShowDockedContextMer:| 
ShowFieldAttributes 


图 8.4 应 用 自 定 义 编辑 器 
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扩展 ArcGIS 服 务 器 


开发 人 员 可 以 使 用 服务 器 API 开 发 任何 类 型 的 应 用 程序 ,开发 ArcGIS Server 应 用 程序 时 ， 
处 理 的 是 运行 在 GIS 服务 器 上 的 远程 ArcObjects 对 象 .因此 ,服务 器 API 包 含 了 许多 ArcObjects 
组 件 , 这 些 组 件 包含 在 一 组 对 象 库 中 。 在 本 章 中 ,将 介绍 如 何 通过 扩展 ArcGIS 服务 器 提高 应 
用 程序 的 性 能 。 


9.1 几 个 概念 
92 使 用 COM 功能 对 象 扩展 GIS 服务 器 
9.3 ”服务 器 对 象 扩展 
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9.1 几 个 概念 
在 扩展 GIS 服务 器 之 间 ， 先 来 认识 几 个 相关 的 概念 。 
9.1.1 ArcGIS 服务 器 与 细 粒 度 的 ArcObjects 


ArcGIS 服务 器 同 ArcGIS Engine 与 ArcGIS 桌面 应 用 程序 一 样 , 使 用 同一 套 ArcObjects, 因此 ， 
如 果 在 服务 器 上 充分 利用 ArcObjects， 那 么 就 可 以 创建 与 ArcGIS 桌面 应 用 程序 类 似 功能 与 性 能 。 

在 应 用 程序 中 , 通过 ArcGIS 服务 器 API, 既 可 以 使 用 粗 粒 度 的 远程 ArcObjects, 例如 MapServer、 
GeoCodeServer、GeoDataServer、GPServer 与 GlobeServer 以 及 它们 的 扩展 的 方法 ， 也 可 以 使 用 细 
粒度 的 远程 ArcObjects， 例 如 循环 处 理 一 多 边 形 中 的 结 点 。 但 是 值得 注意 的 是 ， 在 应 用 程序 中 调用 
运行 在 服务 器 上 的 对 象 ， 属 于 跨 进程 调用 。 例 如 ， 对 于 一 Web 应 用 程序 ，Web 应 用 程序 运行 在 一 
进程 中 ， 而 远程 对 象 运行 在 另 一 进程 中 。 

跨 进程 调用 的 速度 要 比 同 进程 中 调用 慢 许 多 。 通 常 还 有 可 能 的 是 Web 应 用 程序 与 对 象 运行 在 
不 同 的 计算 机 上 ， 因 此 远程 调用 不 仅 跨 进程 ,而 且 跨 计算 机 。 单 独 的 一 次 调用 , 或 者 是 几 十 次 的 调 
用 ,对 于 应 用 程序 的 整体 性 能 影响 意义 不 明显 。 但是， 如 果 应 用 程序 上 千 次 地 跨 进程 或 跨 计算 机 调 
用 GIS 服务 器 上 的 细 粒 度 的 ArcObjects， 那 么 肯定 会 对 应 用 程序 的 性 能 有 明显 的 影响 。 

因此 ， 开 发 人 员 应 该 通过 最 小 化 细 粒 度 调用 远程 对 象 的 次 数 ， 来 最 小 化 应 用 程序 与 GIS 服务 
器 的 往返 交互 。 如 果 在 应 用 程序 中 ,确实 需要 频繁 调用 细 粒 度 的 ArcObjects， 可 以 使 用 两 种 策略 来 
支持 这 种 功能 ， 同 时 保持 远程 调用 的 最 小 化 。 一 个 策略 是 通过 利用 COM 对 象 的 应 用 程序 扩展 GIS 
服务 器 ， 另 一 个 是 使 用 自 定义 的 服务 器 对 象 扩展 。 每 个 策略 都 各 有 优势 。 

使 用 COM 对 象 来 扩展 GIS 服务 器 很 简单 ， 可 允许 开发 人 员 在 ArcGIS 服务 器 、ArcGIS 桌面 产 
品 以 及 ArcGIS Engine 之 间 共 享 自 定义 的 控件 。 这 些 COM 功能 对 象 不 需要 与 任何 特定 的 服务 器 对 
象 配置 或 类 型 绑 定 ， 甚 至 可 以 在 一 个 空 的 服务 器 上 下 文中 使 用 ， 如 图 9.1 所 示 。 但 是 这 种 方法 有 一 
定 的 限制 。 当 使 用 COM 功能 对 象 扩展 GIS 服务 器 时 ， 对 于 服务 器 对 象 或 服务 器 上 下 文 每 次 请 求 ， 
都 会 创建 一 新 的 对 象 ， 这 意味 着 对 于 池 化 的 服务 器 对 象 ， 对 服务 器 对 象 的 每 个 请 求 ， 必 须 创 建 该 
COM 功能 对 象 。 如 果 该 COM 对 象 初始 化 时 需要 消耗 很 高 的 资源 ， 那么 应 该 禁止 这 种 持续 的 创建 。 
此 外 ， 由 于 每 次 请 求 都 创建 新 的 COM 对 象 ， 因 此 不 能 使 用 该 对 象 来 缓存 它 使 用 的 信息 。 

服务 器 对 象 扩 展 与 COM 功能 对 象 正 相反 。 它 与 服务 器 对 象 本 身 一 样 , 在 服务 器 对 象 初始 化 时 ， 
创建 与 初始 化 服务 器 对 象 扩展 ， 并 在 请 求 级 别 重复 使 用 。 因 此 ,即使 服务 器 对 象 扩展 初始 化 需要 消 
耗 大 量 资源 ， 那 么 该 消耗 也 只 有 在 服务 器 对 象 创建 时 才 出 现 ， 是 一 次 性 的 。 同 时 ， 由 于 只 要 服务 器 
对 象 存在 ， 服 务 器 对 象 扩展 实例 就 存在 ， 因 此 可 以 在 请 求 之 间 重 复 使 用 它 的 缓存 信息 。 但 是 ， 服 务 
器 对 象 扩展 与 某 特定 的 服务 器 对 象 配置 或 类 型 绑 定 ， 不 能 像 COM 功能 对 象 那样 广泛 使 用 。 

如 果 应 用 程序 使 用 细 粒 度 的 ArcObjects， 也 不 是 总 是 必须 扩展 服务 器 或 服务 器 对 象 。 正 如 上 面 
介绍 的 ， 这 决定 于 应 用 程序 调用 服务 器 的 数量 。 如 果 应 用 程序 中 常常 需要 上 千 次 地 调用 细 粒 度 的 
ArcObjects， 那 么 就 应 用 考虑 将 其 中 一 些 代码 移动 到 GIS 服务 器 端 。 
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图 9.1 使 用 COM 功能 对 象 扩展 GIS 服务 器 
9.1.2 GIS 服务 器 COM 对 象 与 .NET 


可 以 使 用 COM 语言 ， 例 如 VB、C++ 或 NET， 来 开发 COM 功能 对 象 。 而 服务 器 对 象 扩展 也 
是 作为 COM 对 象 实现 的 , 可 以 使 用 C++ 或 ,NET 来 开发 。 当 使 用 .NET 创建 GIS 服务 器 使 用 的 COM. 
对 象 时 ， 应 该 遵循 如 下 一 些 规则 : 


CD 必须 显 式 创建 COM 类 实现 的 接口 。 与 Visual Basic 6 不 同 ，.NET 不 会 自动 为 COM 类 创 
建 一 个 显 式 接口 ， 而 在 服务 器 上 下 文 创建 对 象 时 需要 使 用 该 接口 。 

(2) COM 类 应 该 生成 一 双重 类 接口 。 这 可 以 通过 在 类 上 增加 ClassInterface 属性 ， 并 将 其 值 
指定 为 ClassInterfaceType.AutoDual 来 实现 。 

(3) 确保 COM 对 象 在 GIS 服务 器 上 能 正确 执行 。COM 对 象 必须 继承 于 ServicedComponet 
类 ， 该 类 位 于 System.EnterpriseServerices 程序 集中 。 


9.2 使 用 COM 功能 对 象 扩 展 GIS 服务 器 


扩展 GIS 服务 器 的 COM 功能 对 象 必须 安装 在 服务 器 对 象 容器 SOC 计算 机 上 ， 只 有 这 样 应 
用 程序 才能 访问 。 例 如 ， 我 们 自 定义 了 一 个 网 络 分 析 功 能 ， 和 希望 能 在 GIS 服务 器 上 使 用 ， 可 以 使 
用 如 下 代码 调用 COM 对 象 : 
mylib.TraceUtilities tracer = 
pServerContext.CreateObject ("mylib.TraceUtilities") 


as mylib.TraceUtilities; 
result = tracer.DoIsolationTrace(...); 


在 上 面 的 代码 中 ， 分 析 功 能 可 能 包含 对 ArcObjects 的 上 千 次 的 调用 ,但 是 所 有 这 些 调用 都 在 
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TraceUtilities 这 个 COM 对 象 运行 的 GIS 服务 器 上 执行 。 粗 粒度 的 DoIsolationTrace 方法 是 Web 应 
用 程序 唯一 需要 调用 的 ， 因 此 这 意味 着 只 需要 对 GIS 服务 器 的 一 次 远程 调用 。 

下 面 我 们 通过 一 个 实例 来 介绍 如 何 利 用 COM 功能 对 象 来 扩展 GIS 服务 器 。 该 实例 包括 两 部 分 。 
一 部 分 是 功能 组 件 ， 另 一 个 部 分 是 Web 应 用 程序 ， 该 程序 将 利用 ArcGIS Server ArcObjects API 来 
访问 功能 组 件 提供 的 自 定义 功能 。 


92.1 COM 组 件 的 创建 与 实现 


在 Visual Studio 中 ， 通 过 File 菜单 的 New Project 命令 ， 创 建 一 类 型 为 Class Library 的 功能 ， 
将 工程 命名 为 VegCOM， 将 解决 方案 命名 为 SpatialQueryCOM。 

在 工程 中 加 入 ESRLArcGIS.Catto 、ESRIArcGIS.Catalog 、 ESRLArcGIS.CatalogUI 、 
ESRI.ArcGIS.Display、ESRI.ArcGIS.Framework、ESRIArcGIS.Geodatabase、ESRI.ArcGIS.Geometry、 
ESRLArcGIS.Server. ESRLArcGIS.esriSystem 以 及 System.EnterpriseServices 程序 集 的 引用 。 

在 工程 中 加 入 一 个 名 为 IVegResults 的 接口 。 在 其 文件 的 头 部 加 入 如 下 命名 空间 的 引用 : 

using ESRI.ArcGIS.Carto; 

using ESRI.ArcGIS.Geodatabase; 

using System.Runtime.InteropServices; 

然后 在 接口 中 加 入 两 个 属性 ,一 个 代表 一 组 图 形 元 素 ， 另 一 个 代表 记录 集 。 这 两 个 属性 的 代码 
如 下 : 

IGraphicElements ResGraphics { 

get; 


set; 


} 


IRecordSet Stats { 
get; 
set; 
) 
由 于 这 里 使 用 的 是 COM 接口 ， 需 要 指定 接口 的 GUID 。 这 可 以 通过 在 接口 定义 处 增加 
GuidAttribute 属性 来 完成 。 即 在 接口 声明 代码 前 一 行 加 入 如 下 代码 : 
[GuidAttribute ("")] 
可 使 用 GUID 生成 工具 生成 一 个 GUID。Visual Studio 2005 安装 时 ， 附 带 安装 了 一 个 GUID ^E 
成 工具 guidgen.exe， 位 于 Visual Studio 安装 路 径 的 Comcom7 Tools 目录 下 。 通 过 Tools 菜单 的 
External Tools 命令 ， 打 开 如 图 9.2 所 示 的 External Tools 对 话 框 。 可 以 通过 该 对 话 框 将 GUID 生成 
工具 命令 加 入 到 Tools 菜单 中 。 
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External Tools 


Menu contents: 


[Dot&fuscator pr Edition | Add 
| 


Delete 


Move Up 


Move Down 


Title: [Cuid Generator 


Command: | Studio 8\CommonT\Tools\gui dken. exe | 
Arguments: [ 
Initial directory: [ 


] 


Use Output window [Prompt for arguments 


Treat output az Unicode Close on exit 


图 9.2 ”通过 External Tools 对 话 框 维护 Tools 菜单 中 的 外 部 命令 


然后 通过 该 命令 ， 打 开 如 图 9.3 所 示 的 Create GUD 对 话 框 。 在 该 对 话 框 中 ， 指 定 GUD 的 格 
式 为 Registry Format, 选择 New GUID 按钮 ,生成 一 个 新 的 GUID, 然后 选择 Copy 按 钮 复制 该 GUID 。 
将 该 GUID 粘贴 到 属性 中 ， 并 删除 其 中 的 “{” 与 “}”。 


Create GUID 


Choose the desired format below, then select "Copy" to 
copy the results to the clipboard (the results can then be 
pasted into your source code). Choose "Exi" when 


GUID Format 
O 1. IMPLEMENT, OLECREATEK(...] 
O 2 DEFINE GUID(...) 


(O3. static const struct GUID = ( ... } 


{30CA2EBF-9279-493-A090-06F6DEB4EBEE} 


图 9.3 Create GUID 对 话 框 


在 工程 中 新 增加 名 为 VegResults 的 类 。 在 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 


using System.Runtime.InteropServices; 
using System.EnterpriseServices; 
using ESRI.ArcGIS.Carto; 

using ESRI.ArcGIS.Geodatabase; 


该 类 也 同样 需要 一 些 类 的 属性 ， 特 别 是 AutomationProxy. ClassInterface 与 GuidAttribute. 7E 
类 定义 的 前 一 行 加 入 如 下 代码 : 
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[AutomationProxy (true) ,ClassInterface (ClassInterfaceType.AutoDual), 
GuidAttribute ("")] 


使 用 GUD 生成 工具 为 类 创建 男 一 个 GUID. AutomationProxy 属性 指定 是 否 应 该 使 用 自动 化 
封 送 拆 收 器 或 自 定义 代理 及 存根 (Stub) 对 该 类 型 进行 封 送 处 理 。 ClassInterface 属性 为 公开 给 COM 
的 类 指定 要 生成 的 类 接口 的 类 型 。 

该 类 需要 继承 ServicedComponent 类 与 实现 IVegResults 接口 。 将 类 的 声明 代码 修改 如 下 : 


public class VegResults : ServicedComponent, IVegResults 
在 类 中 加 入 两 字段 ， 代 码 如 下 : 


private IGraphicElements m resGraphics; 
private IRecordSet m resStats; 


然后 加 入 两 个 属性 ， 代 码 如 下 : 


public IGraphicElements ResGraphics ( 
get ( 
return m resGraphics; 
) 
set ( 
m resGraphics = value as IGraphicElements; 


) 
public IRecordSet Stats ( 


get ( 
return m resStats; 


) 
set ( 

m resStats - value as IRecordSet; 
) 


} 


上 述 代码 实现 了 结果 类 ， 下 面 要 实现 的 是 COM 功能 类 。 
在 工程 中 新 增加 一 个 名 为 IVegUtils 的 接口 ， 该 接口 的 代码 如 下 : 


using System; 

using System.Runtime.InteropServices; 
using ESRI.ArcGIS.Geodatabase; 

using ESRI.ArcGIS.Geometry; 


namespace VegCOM { 
[GuidAttribute ("D3FE0F0A-245E-4e6c-92BC-005B9DC3D93A") ] 
public interface IVegUtils { 
IVegResults sumVegetationType(ref IFeatureClass pVegClass, 
ref IPoint pPoint, ref double dDistance, 
ref string sSummaryFld); 
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接口 中 包含 一 个 名 为 sumVegetationType 的 方法 , 该 方法 用 于 以 pPoint 参数 为 圆心 , 以 dDistance 
参数 为 半径 ， 以 sSummaryFld 为 统计 字段 ， 对 pVegClass 指定 的 图 层 统计 每 个 类 别 的 面积 。 


在 工程 中 新 增加 一 名 为 VegUtils 的 类 。 引 用 命名 空间 的 代码 如 下 : 


using System.EnterpriseServices; 
using System.Collections; 

using System.Collections.Specialized; 
using System.Runtime.InteropServices; 
using ESRI.ArcGIS.Carto; 

using ESRI.ArcGIS.Display; 

using ESRI.ArcGIS.esriSystem; 

using ESRI.ArcGIS.Geodatabase; 

using ESRI.ArcGIS.Geometry; 


类 声明 的 代码 如 下 : 


[AutomationProxy (true)] 

[ClassInterface (ClassInterfaceType.AutoDual)] 
[GuidAttribute ("1EBD03A5-1216-459f-845F-3A61749FAEF7") ] 
public class VegUtils : ServicedComponent, IVegUtils 


类 的 sumVegetationType 方法 的 代码 如 下 : 


public IVegResults sumVegetationType (ref IFeatureClass pVegClass, 
ref IPoint pPoint, ref double dDistance, ref string sSummaryFld) { 
// 计算 点 的 缓冲 区 
ITopologicalOperator pTopoOp = pPoint as ITopologicalOperator; 
IGeometry pGeom = pTopoOp.Buffer (dDistance); 
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// 用 缓冲 区 查询 要 素 图 层 

ISpatialFilter pSFilter = new SpatialFilter(); 

pSFilter.Geometry - pGeom; 

pSFilter.SpatialRel = esriSpatialRelEnum.esriSpatialRelIntersects; 
pSFilter.GeometryField = pVegClass.ShapeFieldName; 


IFeatureCursor pFCursor - pVegClass.Search(pSFilter, true); 


// 对 选择 出 来 的 要 素 进 行 循 环 ， 将 每 个 几何 类 型 裁剪 到 临时 变量 中 
pTopoOp = pGeom as ITopologicalOperator; 
int lPrim = pVegClass.FindField(sSummaryFld); 


ListDictionary dict = new ListDictionary(); 


// 为 几何 图 形 创建 符号 与 图 形 要 素 
ISimpleFillSymbol pSFS = newFillS(); 
IGraphicElements pGraphics = new GraphicElements(); 


IFeature pFeature; 
while ((pFeature = pFCursor.NextFeature()) !- null) ( 
// 创建 图 形 
IFillShapeElement pFE = new PolygonElement() as IFillShapeElement; 
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IElement pElement = pFE as IElement; 


// 裁剪 几何 类 型 

IGeometry pNewGeom = pTopoOp.Intersect (pFeature.Shape, 
esriGeometryDimension.esriGeometry2Dimension); 

pElement.Geometry = pNewGeom; 

pFE.Symbol = pSFS; 

IGraphicElement ge - pFE as IGraphicElement; 

pGraphics.Add (ge); 


// 加 入 到 单 链接 列表 对 象 中 
IArea pArea = pNewGeom as IArea; 
string sType = pFeature.get Value(lPrim) as string; 
if (dict.Contains (sType)) 
dict[sType] = (double)dict[sType] + pArea.Area; 
else 
dict[sType] = pArea.Area; 
) 


// 创建 汇总 记录 集 
IRecordSet psumRS = sumRS (dict); 


// 创建 结果 对 象 

IVegResults pRes new VegResults(); 
pRes.ResGraphics - pGraphics; 
pRes.Stats - psumRS; 


return pRes; 


} 
该 方法 调用 了 sumRS 方法 来 统计 每 个 类 别 的 面积 。sumRS 方法 的 代码 如 下 : 


private IRecordSet sumRS(ListDictionary dict) ( 
// 新 创建 记录 集 对 象 create the new record set 
IRecordSet pNewRs = new RecordSet (); 
IRecordSetInit prsInit - pNewRs as IRecordSetInit; 


IFields pFields = new Fields (); 
IFieldsEdit pFieldsEdit - pFields as IFieldsEdit; 
pFieldsEdit.FieldCount 2 - 2; 


IField pField - new Field(); 

IFieldEdit pFieldEdit = pField as IFieldEdit; 
pFieldEdit.Name 2 - "Type"; 

pFieldEdit.Type 2 = esriFieldType.esriFieldTypeString; 
pFieldEdit.Length 2 = 50; 

pFieldsEdit.set Field(0, pField); 


pField = new Field(); 
pFieldEdit = pField as IFieldEdit; 
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pFieldEdit.Name 2 = "Area"; 
pFieldEdit.Type 2 = esriFieldType.esriFieldTypeDouble; 
pFieldsEdit.set Field(1, pField); 


prsInit.CreateTable (pFields); 


// 增加 所 有 的 类 型 /面积 对 
ICursor pIC = prsInit.Insert(); 
IRowBuffer pRowBuf = prsInit.CreateRowBuffer(); 


IDictionaryEnumerator myEnumerator = dict.GetEnumerator(); 
while (myEnumerator.MoveNext()) ( 

pRowBuf.set Value(0, myEnumerator.Key); 

pRowBuf.set Value(1, myEnumerator.Value); 

pIC.InsertRow (pRowBuf); 


return pNewRs; 


} 
创建 符号 的 newFillS 方法 的 代码 如 下 : 


private ISimpleFillSymbol newFillS() ( 
ISimpleLineSymbol pSLS = new SimpleLineSymbol(); 
IRgbColor pcolor - new RgbColor(); 
pcolor.Red = 255; 
pcolor.Green = 0; 
pcolor.Blue = 0; 
pSLS.Color - pcolor; 
pSLS.Style = esriSimpleLineStyle.esriSLSSolid; 
pSLS.Width - 2; 
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ISimpleFillSymbol pSFS = new SimpleFillSymbol(); 
pSFS.Outline - pSLS; 
pSFS.Style = esriSimpleFillStyle.esriSFSHollow; 


return pSFS; 
) 


至 此 实现 了 COM 组 件 ， 下 面 要 做 的 是 设置 工程 的 程序 集 属性 。 打 开 AssemblyInfo.cs 文件 ， 
将 ComVisibleAttribute 属性 的 值 由 原来 的 false 修改 为 tue。 该 属性 控制 程序 集中 个 别 托管 类 型 、 
员 或 所 有 类 型 对 COM 的 可 访问 性 。 当 创建 Class Library 类 型 的 工程 时 ， 集 成 开发 环境 默认 将 
该 值 设置 为 false， 隐 藏 该 程序 集中 的 所 有 public 类 型 。 即 将 : 
[assembly: ComVisible(false)] 
修改 为 : 


[assembly: ComVisible(true)] 
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9.2.2 注册 COM 组 件 


编译 工程 ， 将 在 bin 目录 下 生成 VegCOM.dll 文件 。 

打开 Visual Studio 2005 命令 行 工 具 〈 开 始 | 程序 | Mircrosoft .NET Framework 2.0 | SDK 
command prompt) ， 切 换 到 VegCOM.dll 文件 所 在 的 目录 。 然 后 运行 如 下 命令 : 

regasm VegCOM.dll /tlb:VegCOM.tlb /codebase 

regasm 是 一 个 程序 集注 册 工 具 ， 用 于 读 取 程 序 集中 的 元 数据 ， 并 将 所 需 的 项 添加 到 注册 表 中 。 
注册 表 人 允许 COM 客户 程序 以 透明 方式 创建 NET Framework 类 。 类 一 经 注册 ， 任 何 COM 客户 


程序 都 可 以 使 用 它 ， 就 好 像 该 类 是 一 个 COM 类 。 类 仅 在 安装 程序 集 时 注册 一 次 。 程 序 集中 的 类 
实例 直到 被 实际 注册 时 ， 才 能 从 COM 中 创建 。 


9.23 使 用 COM 功能 对 象 


用 Manager 工具 将 ArcGIS 安装 目录 下 DeveloperKit\SamplesNET\Server\data\Yellowstone 的 
Yellowstone mxd 发 布 为 Yellowstone 地 图 服务 。 

在 解决 方案 中 加 入 名 为 COMTest 的 Web 站 点 。 在 Default.aspx 页 面 中 加 入 一 地 图 资源 管理 器 
控件 、 一 地 图 控件 、 一 工具 栏 控件 、 一 Toc 控件 、 一 标签 控件 、 一 文本 框 控 件 、 一 复 选 框 控 件 、 
一 IMG 控件 以 及 一 个 Div 控件 ， 并 在 Div 控件 中 加 入 一 个 GridView 控件 。 

在 地 图 资源 管理 器 控件 中 加 入 Yellowstone 地 图 资源 。 在 工具 栏 控件 中 加 入 “放大 ”、“ 缩 小 ”、 

“漫游 ”工具 与 一 个 “ 自 定义 ”的 工具 。 页 面 在 设计 期 间 的 视图 效果 如 图 9.4 所 示 。 


e & © © 
[aot REFE: 
Map WebControl r 
全 在 表格 中 显示 结果 
FreeviewPlus Tocl 
Table of Contents WebControl 
I2, P " 
S-o Column0 Columnl Column? 
apResourceManager - NopResourcellanager! 
MapResourcellanager WebControl 
7 Yellowstone 


图 9.4 页 面 在 设计 期 间 的 视图 


自 定义 工具 对 应 的 类 为 App Code 目录 下 的 VegTool 类 。 在 工程 中 增加 该 类 。 在 类 的 头 部 加 
入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools; 
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using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 
using ESRI.ArcGIS.ADF.Web.DataSources; 

using ESRI.ArcGIS.Carto; 

using ESRI.ArcGIS.esriSystem; 

using ESRI.ArcGIS.Geodatabase; 

using ESRI.ArcGIS.Server; 

using ESRI.ArcGIS.Geometry; 

using ESRI.ArcGIS.ADF.ArcGISServer; 


将 类 的 声明 代码 修改 为 如 下 代码 ， 实 现 IMapServerToolAction 接口 : 
public class VegTool : IMapServerToolAction 


利用 集成 开发 环境 的 代码 自动 生成 功能 生成 IMapServerToolAction 接口 的 代码 框架 ， 也 就 是 
ServerAction 方法 。 在 该 方法 中 首先 加 入 如 下 代码 ， 得 到 服务 器 上 下 文 对 象 与 服务 器 对 象 : 


ESRI.ArcGIS.ADF.Web.UI.WebControls.Map mapctrl = args.Control 
as ESRI.ArcGIS.ADF.Web.UI.WebControls.Map; 


// 从 地 图 控件 中 得 到 地 图 功能 

MapFunctionality mapfunc = 
(MapFunctionality)mapctrl.GetFunctionality ("Yellowstone"); 

MapResourceLocal mapres - (MapResourceLocal)mapfunc.MapResource; 

IServerContext sc = mapres.ServerContextInfo.ServerContext; 

IMapServer map - mapres.MapServer; 


然后 加 入 如 下 代码 ， 从 服务 器 对 象 中 得 到 Yellowstone 地 图 资源 中 的 第 一 个 图 层 对 象 ， 即 植被 
图 层 : 


IMapServerObjects mapobj = (IMapServerObjects)map; 
IMap fgmap = mapobj.get Map (map.DefaultMapName); 
IFeatureLayer fl = (IFeatureLayer)fgmap.get Layer(0); 
IFeatureClass fc - fl.FeatureClass; 


接着 加 入 如 下 代码 ， 根 据 用 户 在 地 图 上 单 击 的 点 ， 得 到 ArcObjects 的 点 对 象 


PointEventArgs pargs = (PointEventArgs)args; 
ESRI.ArcGIS.ADF.Web.Geometry.Point inpt — 
ESRI.ArcGIS.ADF.Web.Geometry.Point.ToMapPoint (pargs.ScreenPoint, 

mapctrl.Extent, 
(int)mapctrl.Width.Value, 
(int)mapctrl.Height.Value); 

IPoint pt = (IPoint)sc.CreateObject ("esriGeometry.Point"); 

pt.X - inpt.X; 

pt.Y = ippt:Y; 


然后 加 入 如 下 代码 ， 得 到 用 户 在 文本 框 中 输入 的 半径 ， 如 果 没 有 输入 ， 则 使 用 默认 值 : 


string tbxvalue (string)mapctrl.Page.Session["TextBoxlValue"]; 
double distance 0; 
if (!Double.TryParse(tbxvalue, out distance)) { 

distance = 10000; 
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然后 加 入 如 下 代码 , 在 服务 器 上 创建 自 定义 的 COM 功能 对 象 , 然后 调用 其 sumVegetationType 
方法 ， 计 算 点 缓冲 区 范围 内 不 同 植被 的 面积 : 


VegCOM.IVegUtils vegutils = null; 

vegutils = (VegCOM.IVegUtils)sc.CreateObject ("VegCOM.VegUtils"); 

string fldName = "PRIMARY "; 

VegCOM. IVegResults vegresults - vegutils.sumVegetationType (ref fc, ref pt, ref 


distance, ref fldName); 
然后 加 入 如 下 代码 ， 绘 制 选择 要 素 的 几何 图 形 : 


IGraphicElements comGraphics = vegresults.ResGraphics; 
GraphicElement[] proxyGraphics = 
(GraphicElement[])ESRI.ArcGIS.ADF.ArcGISServer.Converter.ComObjectToValue 
Object(comGraphics, sc, typeof (GraphicElement[])); 


RgbColor rgb - new RgbColor(); 
rgb.Red - 155; 

rgb.Green - 0; 

rgb.Blue - 0; 

rgb.AlphaValue - 255; 


SimpleLineSymbol sls = new SimpleLineSymbol(); 


sls.Style = ESRI.ArcGIS.ADF.ArcGISServer.esriSimpleLineStyle.esriSLSSolid; 
sls.Color - rgb; 
sls.Width - 0.2; 


foreach (ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement pe in proxyGraphics) ( 
SimpleFillSymbol sfs = (SimpleFillSymbol)pe.Symbol; 
sfs.Outline - sls; 


mapfunc.MapDescription.CustomGraphics = proxyGraphics; 
最 后 加 入 显示 结果 的 代码 ， 如 下 所 示 : 


string cbxvalue = (string)mapctrl.Page.Session["CheckBoxlValue"]; 
if (bool.Parse(cbxvalue)) { 
IRecordSet rs = vegresults.Stats; 
ESRI.ArcGIS.ADF.ArcGISServer.RecordSet value rs = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ComObjectToV 
alueObject(rs, sc, typeof(ESRI.ArcGIS.ADF.ArcGISServer.RecordSet)) 
as ESRI.ArcGIS.ADF.ArcGISServer.RecordSet; 
System.Data.DataTable rsDatatable = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ToDataTable( 
value rs); 
System.Data.DataSet rsDataset = new System.Data.DataSet(); 
rsDataset.Tables.Add (rsDatatable); 
mapctrl.Page.Session["VegDataset"] = rsDataset; 
} 
else ( 
mapctrl.Page.Session["VegDataset"] = null; 
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mapctrl.Refresh(); 
切换 到 Default.aspx.cs 文件 中 , 首先 在 类 的 声明 上 加 上 ICallbackEventHandler 接口 , 代码 如 下 : 


public partial class Default : System.Web.UI.Page, ICallbackEventHandler 


在 类 中 加 入 两 个 字段 : 
public string callBackFunctionInvocation; 
private string returnstring - ""; 


在 类 的 Page Load 方法 中 , 加 入 一 些 会 话 对 象 、 控 件 的 客户 端 函数 ， 并 获取 一 个 对 客户 端 函数 
的 引用 。 代 码 如 下 : 


protected void Page Load (object sender, EventArgs e) { 
if (!IsPostBack) { 
Session["TextBoxlValue"] = "10000"; 
Session["CheckBoxlValue"] = "false"; 
Session["VegDataset"] = null; 


CheckBoxl.Attributes.Add("onclick", "ChangeContext ('CheckBox1')"); 
TextBoxl.Attributes.Add("onblur", "ChangeContext ('TextBox1')"); 
Mapl.Attributes.Add("onmouseup", "ChangeContext ('Map1')"); 
callBackFunctionInvocation = ClientScript.GetCallbackEventReference( 
this, "message", "HandleResponse", "context", "postBackError", true); 
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} 
回调 相关 处 理 方法 的 代码 如 下 : 


public void RaiseCallbackEvent (string eventArgs) { 

if (eventArgs.Contains("tbx")) { 
ChangeTextBoxServer (eventArgs); 

) 

else if (eventArgs.Contains("cbx")) { 
ChangeCheckBoxServer (eventArgs); 

) 

else if (eventArgs.Contains ("mapl")) ( 
ChangeMapServer () ; 

) 


public string GetCallbackResult() ( 
return returnstring; 


) 


public void ChangeTextBoxServer(string ea) { 
char[] parser char = ( ',' }; 
string[] messages = ea.Split(parser char); 
string value = messages[1]; 
Session["TextBoxlValue"] = value; 
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public void ChangeCheckBoxServer(string ea) { 
char[] parser char = ( ',' }; 
string[] messages = ea.Split(parser char); 
string value = messages[1]; 
Session["CheckBoxlValue"] = value; 


public void ChangeMapServer() { 
DataSet ds = (DataSet)Session["VegDataset"]; 


if (ds != null) ( 
GridViewl.DataSource = ds.Tables[0]; 
GridViewl.DataBind(); 


using (System.IO.StringWriter sw - new System.IO.StringWriter()) ( 
HtmlTextWriter htw = new HtmlTextWriter (sw); 
GridViewl.RenderControl (htw); 
htw.Flush(); 
returnstring - sw.ToString(); 


) 
切换 到 Default.aspx 文件 中 ,在 <head> 与 </head> 之 间 的 代码 段 中 加 入 如 下 一 些 JavaScript 函数 : 


<script language="javascript" type="text/javascript"> 
var context; 


function ChangeContext (controlname) { 
context = controlname; 
ChangeClient () ; 


function ChangeClient() ( 
var message; 


if (context == 'TextBox1') ( 
var tbxvalue = document.getElementById('TextBox1').value; 


message = 'tbx'; 
message += ',' + tbxvalue; 


) 


if (context == 'CheckBox1') { 
var cbxvalue = document.getElementById('CheckBox1').checked; 


message = 'cbx'; 

message += ',' + cbxvalue; 
) 
if (context == 'Mapl') { 


document.getElementById('loadingdiv').style.visibility = 
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"visible"; 
message = 'mapl'; 


} 


«$-callBackFunctionInvocation$» 


) 


function HandleResponse (returnvalue, ctx) { 
var griddiv = document.getElementById('griddiv'); 


if (ctx == "Mapl") ( 
if (returnvalue !- "") { 
griddiv.style.visibility - "visible"; 
griddiv.innerHTML - returnvalue; 


H 

else 1f (returnvalúues == "") f 
griddiv.style.visibility = "hidden"; 

} 


} 


if (ctx == "Mapl") { 
document.getElementById('loadingdiv').style.visibility ="hidden"; 
} 
} 
</script> 


编译 并 运行 程序 。 选 择 “ 在 表格 中 显示 结果 ” 复 选 框 ， 然 后 先 选择 自 定 义工 具 ， 这 时 在 地 图 上 
Ff, 服务 器 将 计算 以 该 点 为 圆心 , 指定 半径 范围 内 各 种 植被 的 面积 。 程序 运行 效果 如 图 9.5 Bras 


rz 


J Untitled Page — Microsoft Internet Explorer 
XD MEO EV KRA IAV MMW 
E http: //1ocalhost/Spati alQueryCON/CONTest/ 


回 在 表格 中 显示 结果 
s 回 Yellowstone 
5 [2 Vegetation 


Alpine tundra 
~“ Big Sagebrush 
Douglas-fir 


Type Area 
[Water 105406479.38949: 
Subalpine Fir 190551663.52048: 
Sedge bogs — 8583120.4651530. 
Wet forests — 4207278.0324937. 


[Idaho Fescue 1607804.9218612'* 
> 
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9.3 ”服务 器 对 象 扩展 


服务 器 对 象 扩 展 是 扩展 GIS 服务 器 功能 的 另 一 种 方法 。 服 务 器 对 象 扩展 的 目的 ， 就 是 将 客户 
端的 许多 细 粒 度 的 调用 ， 封 装 为 粗 粒度 的 方法 ， 从 而 减少 对 GIS 服务 器 的 调用 。 
与 COM 对 象 相 比 ， 扩 展 服 务 器 对 象 具 有 如 下 一 些 优势 : 


CD 开发 人 员 不 需要 在 上 下 文中 显 式 创建 服务 器 对 象 扩展 。 当 服务 器 对 象 实例 创建 时 ，GIS 


服务 器 同时 创建 服务 器 对 象 扩展 。 
(2) 如 果 服务 器 对 象 扩 展 的 功能 需要 消耗 较 多 的 资源 ， 那 么 只 有 在 服务 器 对 象 初始 化 时 ， 才 
需要 消耗 该 资源 。 


(3) 可 以 使 用 缓存 。 
(4) ArcGIS Server 管理 应 用 程序 可 以 应 用 服务 器 对 象 扩展 的 配置 对 话 框 。 


创建 服务 器 对 象 扩展 的 流程 如 下 : 

(1) 创建 一 个 实现 IServerObjectExtension 接口 与 自 定义 接口 的 COM 对象。 还 可 选择 实现 其 
他 一 些 接口 ， 包 括 IObjectConstruct、ILogSupport 与 IObjectActivate 接口 。 

COD 如 果 有 必要 ， 还 可 创建 实现 IAGSSOEParameterPage 与 ICOMPropertyPage 接口 的 用 户 窗 
体 ， 用 于 设置 扩展 的 属性 。 

(3) 在 每 台 服务 器 对 象 容器 计算 机 、 服 务 器 对 象 管理 器 计算 机 以 及 开发 计算 机 上 注册 第 一 步 
创建 的 服务 器 扩展 COM 对 象 。 

(4) 使 用 IServerObjectAdmin2 接口 的 AddExtensionType 方法 在 GIS 服务 器 上 注册 服务 器 对 
象 扩 展 。 

C5) 如 果 必 要 ， 在 每 台 ArcGIS 桌面 应 用 程序 计算 机 上 注册 第 二 步 创 建 的 属性 页 。 

(6) 创建 一 个 包含 服务 器 对 象 扩 展 的 服务 器 对 象 配置 。 

(7) 创建 使 用 服务 器 对 象 及 其 扩展 的 应 用 程序 。 


下 面 我 们 将 通过 一 个 实例 演示 如 何 创建 服务 器 对 象 扩展 。 实 现 的 功能 与 9.2 节 COM 功能 对 象 
的 功能 类 似 。 


9.3.1 创建 服务 器 对 象 接口 扩展 


在 Visual Studio 2005 中 ， 通 过 File 菜单 的 New Project 命令 ， 创 建 一 个 Class Library 的 工程 ， 
命名 为 VegSOEInterface。 将 解决 方案 命名 为 VegSOE。 

在 工程 中 加 入 一 个 类 , 命名 为 VegSOEInterfaces。 删 除 其 中 所 有 的 代码 ,然后 在 其 中 加 入 
如 下 代码 : 

using System.Runtime.InteropServices; 

using ESRI.ArcGIS.Geometry; 


using ESRI.ArcGIS.Carto; 
using ESRI.ArcGIS.Geodatabase; 
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namespace VegSOEInterfaces { 
[GuidAttribute ("70a7fbc8-ab8e-4e3c-810f-4e0f46f62e49")] 
public interface IVegUtilsSOE { 
IVegResultsSOE sumVegetationType(IPoint pPoint, double dDistance); 
) 


[GuidAttribute ("3c09de7a-cO0ce-4c6f-b1b6-8100e712c1b2")] 
public interface IVegResultsSOE ( 
IGraphicElements ResGraphics { 
get; 
set; 
} 
IRecordSet Stats { 
get; 
set; 


} 

上 面 的 代码 ， 定 义 了 两 个 接口 。 其 中 IVegUtilsSOE 接口 定义 了 将 要 被 vegutilssoE 类 实现 
的 基本 框架 。IVegResultsSOE 接口 定义 了 将 要 被 VegResultsSOE 类 实现 的 基本 框架 。 由 于 两 个 
接口 都 要 注册 为 COM 对 象 ， 因 此 需要 指定 一 个 唯一 的 GUID。 


$ 在 工程 中 加 入 ESRIArcGIS.Carto ~ ESRI.ArcGIS.Display ~ ESRLArcGIS.Geodatabase 、 
em ESRLArcGIS.Geometry, ESRLArcGIS.Server,. ESRLArcGIS.System 与 System.EnterpriseServices 程 
un 序 集 的 引用 。 
打开 该 工程 的 AssemblyInfo.cs 文 件 , 将 ComVisibleAttribute 属 性 的 值 由 原来 的 false 修 改 为 tue。 
即将 : 
[assembly: ComVisible (false)] 
修改 为 : 


[assembly: ComVisible (true)] 
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在 当前 解决 方案 中 加 入 名 为 VegSOE 的 Class Library 类 型 的 工程 。 在 工程 中 加 入 
ESRI.ArcGIS.Carto 、 ESRLArcGIS.Catalog 、 ESRLArcGIS.CatalogUI ~ ESRLArcGIS.Display 
ESRLArcGIS.Framework, ESRI.ArcGIS.Geodatabase, ESRI.ArcGIS.Geometry, ESRLArcGIS.Server. 
ESRLArcGIS.System 与 System.EnterpriseServices 程序 集 的 引用 。 还 需要 加 入 VegSOEInterface 工程 
的 引用 。 

将 默认 加 入 的 Classl.cs 文件 更 名 为 VegResultsSOE.cs， 集 成 开发 环境 将 自动 将 类 名 改 为 
VegResultsSOE。 在 类 的 头 部 加 入 如 下 一 些 命名 空间 的 引用 : 


T 


using System.Collections.Specialized; 
using System.Runtime.InteropServices; 
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using System.EnterpriseServices; 
using ESRI.ArcGIS.Carto; 
using ESRI.ArcGIS.Geodatabase; 


VegResultssoE 类 的 实现 代码 很 简单 ， 代 码 如 下 : 


[AutomationProxy (true)] 
[ClassInterface (ClassInterfaceType.None)] 
[GuidAttribute ("05922ca8-1a80-4502-8bbf-b3c0637b80ac") ] 
public class VegResultsSOE : 
ServicedComponent, VegSOEInterfaces.IVegResultsSOE 
t 

private IGraphicElements m resGraphics; 

private IRecordSet m resStats; 


public IGraphicElements ResGraphics ( 
get ( 
return m resGraphics; 
) 
set ( 
m resGraphics = (IGraphicElements) value; 


public IRecordSet Stats ( 
get ( 
return m resStats; 
) 
set ( 
m resStats - (IRecordSet)value; 


) 
在 工程 中 新 加 入 名 为 vegutilssoE 的 类 。 在 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 


using System.Runtime.InteropServices; 
using System.EnterpriseServices; 
using ESRI.ArcGIS.Carto; 

using ESRI.ArcGIS.Display; 

using ESRI.ArcGIS.esriSystem; 

using ESRI.ArcGIS.Geodatabase; 

using ESRI.ArcGIS.Geometry; 

using ESRI.ArcGIS.Server; 


修改 类 的 声明 代码 : 


[AutomationProxy (true)] 

[ClassInterface (ClassInterfaceType.None)] 

[GuidAttribute ("87176523-1ede-4fe6-abe0-66481ac7d04b")] 

public class VegUtilsSOE : ServicedComponent, VegSOEInterfaces.IVegUtilsSOE, 
IServerObjectExtension, IObjectConstruct, ILogSupport, IObjectActivate 
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该 类 继承 ServicedComponent 类 ， 还 需要 实现 VegSOEInterfacesIVegUtilsSOE 、 
IServerObjectExtension, IObjectConstruct, ILogSupport 与 IObjectActivate 接口 。 
服务 器 对 象 扩展 初始 化 时 各 接口 中 方法 的 调用 顺序 如 图 9.6 所 示 。 


Server object created 


CreateServerContext II ObjectActivate: Activate 


ReleaseServerContext 
IIObjectActivate:Deactivate |4—— 
图 9.6 服务 器 对 象 扩展 初始 化 时 各 方法 的 调用 顺序 


ServicedComponent 是 使 用 COM 服务 的 所 有 类 的 基 类 。 只 需要 进行 声明 ， 而 不 需要 任何 额外 
的 代码 。 

如 果 希 望 服务 器 对 象 扩展 能 在 GIS 服务 器 日 志文 件 中 记录 日 志 消 息 ， 则 必须 实现 ILogSupport 
接口 。 该 接口 中 只 有 一 个 InitLogging 方法 。 当 服务 器 对 象 扩展 创建 时 ， 调 用 该 方法 ， 获 取 GIS 服 
务 器 日 志 对 象 的 引用 。 一 旦 有 了 服务 器 日 期 的 引用 ，, 便 可 随时 调用 AddMessage 方法 往日 志 中 加 入 
消息 。 在 VegUtilsSOE 中 加 入 一 服务 器 日 志 引 用 字段 以 及 InitLogging 方法 的 实现 ， 代 码 如 下 : 
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private ILog m log; 
public void InitLogging(ILog log) { 
m log = log; 
) 
服务 器 对 象 扩展 中 最 重要 的 接口 是 IServerObjectExtension. 所 有 服务 器 对 象 扩展 必须 实现 该 接 
口 。 该 接口 中 包含 两 个 方法 ， 分 别 是 Init 与 Shutdown。 从 这 两 个 方法 的 名 称 ， 可 以 看 出 ， 该 接口 
于 服务 器 对 象 管理 扩展 的 整个 生命 周期 。 服 务 器 对 象 扩 展 必 须 通过 服务 器 对 象 帮助 器 
CIServerObjectHelper) 才能 调用 服务 器 对 象 的 任何 方法 〈 当 服务 器 对 象 扩展 创建 时 调用 Init 方法 。 
Shutdown 方法 通过 服务 器 对 象 的 上 下 文 被 关闭 ， 并 即将 销毁 ， 因 此 需要 在 该 方法 中 释放 服务 器 对 
象 帮助 器 的 引用 ) 。 在 VegutilssoE 类 中 加 入 服务 器 对 象 帮助 器 的 引用 及 上 述 两 个 方法 的 实现 ， 
代码 如 下 : 


private IServerObjectHelper m SOH; 


public void InitLogging(ILog log) { 
m log - log; 
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public void Init(IServerObjectHelper pSOH) ( 
m SOH = pSOH; 


m log.AddMessage(3, 8000, "VegUtilsSOE custom message. Init called"); 


) 


public void Shutdown() ( 


m log.AddMessage(3, 8000, "VegUtilsSOE custom message. Shutdown called"); 


m SOH = null; 
m layer - null; 
m log - null; 

) 


如 果 服 务 器 对 象 扩展 包含 配置 属性 或 需要 其 他 额外 的 初始 化 处 理 ， 则 需要 实现 接口 
IObjectConstruct 。 该 接口 仅 包 含 一 个 方法 Constmuct 。 服 务 器 对 象 扩 展 创 建 时 ， 在 调用 . 


IServerObjectExtension 接口 的 Init 方法 之 后 ， 调 用 Construct 方法 。 


配置 属性 存储 在 服务 器 对 象 的 配置 文件 中 。 配 置 文 件 的 命名 方式 为 “服务 名 称 .服务 器 对 象 类 
型 .cfg”, 存储 在 SOM 计算 机 的 ArcGIS 安装 目录 的 Server\user\cfg 路 径 中 。 例如, 名 为 Yellowstone 
的 地 图 服务 的 配置 文件 的 名 称 为 Yellowstone.MapServer.cfg。 在 我 们 这 个 实例 中 ， 需 要 从 配置 文件 


中 读 入 图 层 与 字段 属性 。 在 VegUti1lsSOE 类 中 加 入 如 下 代码 : 


private ILayer m layer; 
private string m layerName; 
private string m fieldName; 


public void Construct(IPropertySet props) { 
try ( 
m layerName = props.GetProperty("LayerName") as 
m fieldName = props.GetProperty ("FieldName") as 


) 


catch (Exception ex) ( 
m log.AddMessage(1, 8000, 


"VegUtilsSOE custom error. Error reading properties: 


+ ex.Message + " " + props.Count.ToString()); 
return; 


try ( 
IMapServer ms = (IMapServer)m SOH.ServerObject; 
IMapServerObjects mso - (IMapServerObjects)ms; 
IMap map = mso.get Map (ms.DefaultMapName); 
UID ltype = new UIDClass(); 
ltype.Value = "(E156D7E5-22AF-11D3-9F99-00COA4F6B! 
IEnumLayer el = map.get Layers(ltype, true); 
el.Reset(); 


ILayer 1 = null; 
while ((1 = el.Next()) !- null) ( 


string; 
string; 


C78E)"; 
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if (l.Name == m layerName) ( 
m layer = 1; 
break; 


) 


if (m layer == null) ( 
m log.AddMessage(1, 8000, "VegUtilsSOE custom error: Layer " 
* m layerName * " not found."); 
return; 


) 


(IFeatureLayer)m layer; 
fl.FeatureClass; 


IFeatureLayer fl 
IFeatureClass fc 


if (fc.FindField(m fieldName) == -1) 
m log.AddMessage(1, 8000, "VegUtilsSOE custom error: Field " 
+ m fieldName + " not found in layer " + m layerName); 


else 
m log.AddMessage (3, 8000, "VegUtilsSOE successfully initialized."); 


) 
catch (Exception ex) ( 
m log.AddMessage(1, 8000, 
"VegUtilsSOE custom error: Failed to initialize extension: " 
+ ex.Message + "::" + ex.StackTrace.Length.ToString()); 
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) 

IServerObjectExtension 接口 的 Init 方法 与 IObjectConstruct 接口 的 Construct 方法 ， 只 有 在 服务 
器 对 象 扩展 创建 时 才 被 调用 。 然 而 如 果 需 要 在 每 次 服务 器 上 下 文 获 取 或 释放 时 CHI. Web 端 调 用 
CreateServerContext 与 ReleaseContext) ， 运 行 服务 器 对 象 扩 展 ， 则 需要 实现 接口 IObjectActivate。 
该 接口 包含 两 个 方法 ， 分 别 是 Activate 与 Deactivate。 当 Web 端 每 次 调用 CreateServerContext 方法 
时 ， 调 用 Activate 方法 ， 而 每 次 调用 ReleaseContext 释放 服务 器 上 下 文 时 调用 Deactivate 方法 。 在 
VegUtilsSOE 类 中 加 入 实现 IServerObjectExtension 接口 方法 的 代码 : 


public void Deactivate() { 
m log.AddMessage (3, 8000, 
"VegUtilsSOE custom message. Deactivate called"); 


) 


public void Activate() ( 
m log.AddMessage(3, 8000, 
"VegUtilsSOE custom message. Activate called"); 


h 
下 面 加 入 IVegUtilsSOE 接口 需要 实现 的 方法 ， 实 现 统计 指定 字段 中 各 类 地 物 的 面积 。 代 码 如 
Ts 


public VegSOEInterfaces.IVegResultsSOE sumVegetationType( 
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IPoint pPoint, double dDistance) 


{ 


if (m layer == null) { 
m log.AddMessage (1, 8000, "VegUtilsSOE custom error: layer not found"); 
return null; 


IFeatureLayer fl = (IFeatureLayer) m layer; 
IFeatureClass pVegClass = fl.FeatureClass; 


ITopologicalOperator pTopoOp - (ITopologicalOperator) pPoint; 
IGeometry pGeom = pTopoOp.Buffer (dDistance); 


ISpatialFilter pSFilter - new SpatialFilter(); 

pSFilter.Geometry - pGeom; 

pSFilter.SpatialRel = esriSpatialRelEnum.esriSpatialRelIntersects; 
pSFilter.GeometryField = pVegClass.ShapeFieldName; 


IFeatureCursor pFCursor - pVegClass.Search(pSFilter, true); 


pTopoOp = (ITopologicalOperator) pGeom; 
int lPrim - pVegClass.FindField(m fieldName); 


ListDictionary dict - new ListDictionary(); 


ISimpleFillSymbol pSFS = newFillS(); 
IGraphicElements pGraphics = new GraphicElements(); 


IFeature pFeature; 

while ((pFeature - pFCursor.NextFeature()) !- null) ( 
IFillShapeElement pFE = (IFillShapeElement) new PolygonElement (); 
IElement pElement = pFE as IElement; 


IGeometry pNewGeom = pTopoOp.Intersect (pFeature.Shape, 
esriGeometryDimension.esriGeometry2Dimension); 

pElement.Geometry = pNewGeom; 

pFE.Symbol = pSFS; 

IGraphicElement ge = (IGraphicElement) pFE; 

pGraphics.Add (ge); 


IArea pArea = pNewGeom as IArea; 
string sType - pFeature.get Value(lPrim) as string; 
if (dict.Contains (sType)) 

dict[sType] = (double)dict[sType] + pArea.Area; 
else 

dict[sType] = pArea.Area; 
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IRecordSet psumRS = sumRS (dict); 
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VegSOEInterfaces.IVegResultsSOE pRes = new VegResultsSOE(); 
pRes.ResGraphics = pGraphics; 
pRes.Stats = psumRS; 


return pRes; 


private IRecordSet sumRS( 
System.Collections.Specialized.ListDictionary dict) 
í 
IRecordSet pNewRs = new RecordSet (); 
IRecordSetInit prsInit = pNewRs as IRecordSetInit; 


IFields pFields = new Fields (); 
IFieldsEdit pFieldsEdit = pFields as IFieldsEdit; 
pFieldsEdit.FieldCount_2 = 2; 


IField pField = new Field(); 

IFieldEdit pFieldEdit = pField as IFieldEdit; 
pFieldEdit.Name 2 = "Type"; 

pFieldEdit.Type 2 = esriFieldType.esriFieldTypeString; 
pFieldEdit.Length 2 = 50; 

pFieldsEdit.set Field(0, pField); 


pField = new Field(); 
pFieldEdit = pField as IFieldEdit; 
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pFieldEdit.Name 2 "Area"; 
pFieldEdit.Type 2 = esriFieldType.esriFieldTypeDouble; 
pFieldsEdit.set Field(1, pField); 


prsInit.CreateTable (pFields); 


ICursor PIC = prsInit.Insert(); 
IRowBuffer pRowBuf = prsInit.CreateRowBuffer(); 


System.Collections.IDictionaryEnumerator myEnumerator = 
dict.GetEnumerator(); 

while (myEnumerator.MoveNext()) ( 
pRowBuf.set Value(0, myEnumerator.Key); 
pRowBuf.set Value(1, myEnumerator.Value); 
pIC.InsertRow (pRowBuf); 


return pNewRs; 


private ISimpleFillSymbol newFillS() ( 
ISimpleLineSymbol pSLS = new SimpleLineSymbol(); 
IRgbColor pcolor - new RgbColor(); 


修改 
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序 集 


两 个 


pcolor.Red = 0; 

pcolor.Green - 255; 

pcolor.Blue - 0; 

pSLS.Color = pcolor; 

pSLS.Style = esriSimpleLineStyle.esriSLSSolid; 
pSLS.Width - 2; 


ISimpleFillSymbol pSFS = new SimpleFillSymbol(); 
pSFS.Outline - pSLS; 
pSFS.Style = esriSimpleFillStyle.esriSFSHollow; 


return pSFS; 
} 
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打开 该 工程 的 AssemblyInfo.cs 文 件 ,将 ComVisibleAttribute 属性 的 值 由 原来 的 false 修 改 为 tmue。 
即将 : 


[assembly: ComVisible (false)] 
为 : 


[assembly: ComVisible (true)] 


.3 创建 服务 器 对 象 扩展 的 属性 页 


在 解决 方案 中 增加 一 名 为 VegSOEProps 的 Class Library 类 型 的 工程 。 在 工程 中 加 入 
ESRI.ArcGIS.Carto 、ESRI.ArcGIS.System 、ESRI.ArcGIS.Geodatabase 、ESRI.ArcGIS.Geometry 、 
ESRLArcGIS.Catalog, ESRLArcGIS.CatalogUI,. ESRLArcGIS.Framework 与 ESRIArcGIS.Server 程 


的 引用 。 


在 当前 工程 中 加 入 一 名 为 FormVegProps 的 Windows Form。 在 该 窗 体 中 增加 三 个 标签 控件 与 


下 拉 列 表 框 控件 。 在 窗 体 设 计 期 间 的 视图 如 图 9.7 所 示 。 


Select the layer and summary field for the extension: 


Layer: w 


Field: i 


E 
图 9.7 服务 器 对 象 扩展 的 属性 页 在 设计 期 间 的 视图 
打开 该 窗 体 的 代码 ， 在 头 部 加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.Carto; 
using ESRI.ArcGIS.esriSystem; 
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增加 返回 窗 体 句柄 的 方法 ， 在 ArcCatalog 中 显示 属性 页 时 需要 该 方法 。 代 码 如 下 : 


窗 体 需要 引用 地 图 文档 、 图 层 以 及 字段 名 称 。 因 此 加 入 如 下 一 些 字段 及 对 应 属性 的 代码 : 


第 9 章 扩展 ArcGIS 服务 器 4 Qu) 


IFeatureClass fc — fl.FeatureClass; 


if (fc.ShapeType == esriGeometryType.esriGeometryPolygon 
&& fc.FeatureType == esriFeatureType.esriFTSimple) 
ComboLayers.Items.Add(1.Name); 


if (m layer —- null) 
ComboLayers.SelectedIndex - 0; 
else ( 
IEnumerator itemenum = ComboLayers.Items.GetEnumerator(); 
while (itemenum.MoveNext()) ( 
string lname = itemenum.Current.ToString(); 
if (lname -- m layer) 
ComboLayers.SelectedIndex - 
ComboLayers.Items.IndexOf (itemenum.Current); 


} 
加 入 处 理 下 拉 列 表 框 改变 选择 的 事件 响应 方法 的 代码 : 


private void ComboLayers SelectedIndexChanged(object sender, EventArgs e) 
{ 
ComboFields.Items.Clear(); 


IMap map = m map.get Map(0); 


UID id = new UIDClass(); 
id.Value = "(E156D7E5-22AF-11D3-9F99-00C04F6BC78E]"; 
IEnumLayer el = map.get Layers(id, true); 


ILayer 1 = null; 
while ((1 = el.Next()) != null) ( 
if (l is IFeatureLayer && l.Name == ComboLayers.Text) ( 
IFeatureLayer fl = (IFeatureLayer) 1; 
IFields flds - fl.FeatureClass.Fields; 


for (int i = 0; i < flds.FieldCount; i++) ( 
IField fld - flds.get Field(i); 
ComboFields.Items.Add(fld.Name); 


if (m field == null) 
ComboFields.SelectedIndex = 0; 
else ( 
IEnumerator itemenum = ComboFields.TItems.GetEnumerator(); 
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while (itemenum.MoveNext()) { 
string fname = itemenum.Current.ToString(); 
if (fname — m field) 
ComboFields.SelectedIndex = 
ComboFields.Items.IndexOf (itemenum.Current); 


m layer = ComboLayers.SelectedItem.ToString(); 


) 


private void ComboFields SelectedIndexChanged(object sender, EventArgs e)í( 
m field - ComboFields.Text; 


} 


private void FormVegProps FormClosed(object sender, FormClosedEventArgs e){ 
m map.Close(); 
m map = null; 


) 
窗 体 


S c 


用 于 呈现 界面 ， 真 正 实现 设置 还 需要 一 个 类 。 在 工程 中 新 增加 名 为 VegSOEProps 


是 
的 类 。 在 该 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 


using System.Runtime.InteropServices; 
using ESRI.ArcGIS.Carto; 

using ESRI.ArcGIS.Catalog; 

using ESRI.ArcGIS.CatalogUI; 

using ESRI.ArcGIS.esriSystem; 

using ESRI.ArcGIS.Server; 

using ESRI.ArcGIS.Framework; 

using ESRI.ArcGIS.Utility.CATIDs; 


将 类 的 声明 修改 为 如 下 代码 : 


[GuidAttribute ("EB085B89-D01F-448c-98F0-448FOBECBOBF") ] 


中 注 


public 


class VegSOEProps : IComPropertyPage, IAGSSOEParameterPage 


在 类 中 增加 如 下 几 个 字段 : 


private IPropertySet m props; 

private IPropertySet m soprops; 

private string m exttype; 

private string m sotype; 

private FormVegProps propertyPage; 

当 在 ArcCatalog 中 需要 创建 与 显示 属性 页 时 ， 需 要 调用 该 属性 页 类 。VegSOEProps 类 的 构造 
函数 用 于 初始 化 成 员 变量 。 在 该 函数 中 ， 创 建 一 个 FormVegProps 窗 体 实例 ， 并 赋予 propertyPage 
字段 。 服 务 器 对 象 扩展 将 被 注册 用 于 MapServer 类 型 的 服务 器 对 象 ， 也 就 是 m_sotype 字段 指定 的 
值 , 而 扩展 对 象 的 名 称 , 即 VegUtilitiesSOE, 使 用 m exttype 字段 存储 , 该 值 必须 与 在 ArcGIS Server 


E 册 时 使 月 


目的 名 称 一 致 。 析 构 函 数 用 于 显 式 销毁 属性 页 。 构 造 函 数 与 析 构 函数 的 代码 如 下 : 
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属性 页 类 需要 实现 IComPropertyPage 与 IAGSSOEParameterPage 两 个 接口 。 
IComPropertyPage 接口 定义 了 ArcCatalog 与 属性 页 交互 的 框架 。 在 类 中 加 入 如 下 代码 , 实现 该 
接口 : 
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set { 
) 
H 


public void Apply() ( 
) 


public IComPropertyPageSite PageSite { 
set { 
) 

) 


public void Deactivate() ( 
} 


public int Height { 
get { 
return 0; 
} 
} 


public void Show() { 
propertyPage.Show(); 
) 
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public string HelpFile { 
get { 
return null; 


} 


public int Activate() { 
return propertyPage.getHWnd(); 


public bool Applies(ISet objects) ( 
return false; 


public void Hide() ( 
propertyPage.Hide(); 


IAGSSOEParameterPage 接口 中 定义 了 一 组 属性 ， 自 定义 的 服务 器 对 象 扩展 需要 显 式 实现 。 该 
接口 通过 在 该 类 中 定义 的 服务 器 对 象 及 其 扩展 属性 , 以 及 地 图 服务 器 对 象 的 配置 文件 , 更 新 属性 页 
与 配置 文件 。 服务 器 对 象 的 配置 属性 存储 在 服务 器 对 象 配置 文件 中 。 而 服务 器 对 象 扩展 的 属性 也 存 
储 在 该 配置 文件 中 。 在 本 实例 中 ， 需 要 将 我 们 自 定义 的 服务 器 对 象 扩展 的 属性 ， 即 LayerName 与 
FieldName 写 到 配置 文件 中 ， 此 外 需要 从 该 配置 文件 中 读 入 三 个 属性 ， 分 别 是 自 定义 服务 器 对 象 扩 
展 的 两 个 属性 与 一 个 服务 器 对 象 自身 的 属性 (FilePath) 。 
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ServerObjectProperties 属性 只 存储 服务 器 对 象 的 属性 ， 而 不 包括 扩展 的 属性 。 如 果 服 务 器 对 象 
扩展 已 经 被 配置 ， 那 么 LayerName 与 FieldName 属性 中 就 有 值 。 如 果 没 有 ， 则 只 有 服务 器 对 象 的 
地 图 文档 的 路 径 可 使 用 。 当 属性 页 窗 体 打 开 时 ， 调 用 ServerObjectProperties 属性 的 set 方法 。 

ExtensionProperties 属性 管理 服务 器 对 象 扩展 文件 中 属性 的 访问 。 在 本 实例 中 ， 如 果 服 务 器 对 
象 扩展 可 使 用 ， 那 么 在 服务 器 对 象 配 置 文 件 中 会 加 入 如 下 属性 : 


<Extension> 
<TypeName>VegUtilitiesSOE </TypeName> 
<Enabled>true</Enabled> 
<Properties> 
<LayerName>Vegetation</LayerName> 
<FieldName>PRIMARY </FieldName> 
</Properties> 
<Info> 
<WebEnabled>true</WebEnabled> 
<WebCapabilities></WebCapabilities> 
</Info> 
</Extension> 


可 以 通过 属性 页 改变 LayerName 与 FieldName 属性 的 值 。 当 在 ArcCatalog 中 选择 了 某 服务 器 
对 象 扩展 ， 那 么 这 些 属性 就 会 被 加 入 到 地 图 服务 器 对 象 的 配置 文件 中 。 通 过 ExtensionProperties 属 
性 的 get 方法 在 配置 文件 中 增加 属性 。 如 果 属 性 值 已 经 加 入 到 配置 文件 中 ， 那 么 该 属性 的 set 方法 
就 会 读 入 属性 值 。 

当 属性 页 初始 化 时 ， 设 置 ServerObjectExtensionType 与 ServerObjectType 属性 。 


public IPropertySet ServerObjectProperties ( 
get { return m soprops; } 
set ( 
m soprops - value; 


try ( 
propertyPage.theLayer — 
m props.GetProperty ("LayerName").ToString(); 
propertyPage.theField = 
m props.GetProperty ("FieldName").ToString(); 
propertyPage.setMap(m soprops.GetProperty ("FilePath").ToString()); 
) 
catch ( 
propertyPage.setMap (m soprops.GetProperty ("FilePath").ToString()); 
) 


} 
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public IPropertySet ExtensionProperties { 
get { 
m props.SetProperty ("LayerName", propertyPage.theLayer); 
m props.SetProperty ("FieldName", propertyPage.theField); 
return m props; 
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set ( 
m props - value; 


public string ServerObjectExtensionType { 
get ( 
return m exttype; 


) 


public string ServerObjectType { 
get ( 
return m sotype; 
) 
} 


为 了 能 在 ArcCatalog 中 访问 属性 页 ,需要 将 其 注册 为 AGS Extension Parameter Pages 组 件 类 型 。 
当 属 性 页 类 注册 为 COM 时， 实现 该 注册 。 在 类 中 加 入 如 下 代码 进行 注册 : 


[ComRegisterFunction()] 
static void RegisterFunction(String regKey) { 
Microsoft.Win32.Registry.ClassesRoot.CreateSubKey (regKey.Substring(18) 
+ "AAImplemented Categories WV" 
+ "(A585A585-B58B-4560-80E3-87A411859379]") ; 


[ComUnregisterFunction()] 
static void UnregisterFunction(String regKey) ( 
Microsoft.Win32.Registry.ClassesRoot.CreateSubKey (regKey.Substring(18) 
+ "AAImplemented Categories WV" 
+ "(A585A585-B58B-4560-80E3-87A411859379]") ; 
) 


要 查看 注册 的 ArcGIS 组 件 类 型 , 可 以 运行 ArcGIS 安装 目录 下 的 bin 路 径 中 的 categoris.exe 程 
序 ， 并 选择 某 类 型 。 该 程序 运行 界面 如 图 9.8 所 示 。 


Š Component Category Manager [olx] 


E- Active Scripting Engine with Encoding [: Cm ] 


55) (E Active Scripting Engine with Parsing =| 


68i (E ABS Connection Admin Property Pages Add Object... 
58i (E AGS Connection User Property Pages 


2&i 
L- CKmPeremPage Object Bemove bed. 


zB CWMSParamPage Object 
过 VegSOEProps VegSOEProps. 
四 (C AGS Folder Property Pages 


由 - 国 ABS Geocode Property Pages =T 
外国 AGS GeoDataServer Property Pages m | 


i 


Category: 


田 AGS Geoprocessing Server Property Pages 
2-0 AGS Globe Server Property Pages 
m- AGS Map Property Pages 


|Tip: Select the object you want to change. 


图 9.8 ArcGIS 组 件 类 型 管理 器 
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打开 该 工程 的 AssemblyImfo.cs 文 件 , 将 ComVisibleAttribute 属性 的 值 由 原来 的 false 修 改 为 tue。 
即将 : 


[assembly: ComVisible(false)] 
修改 为 : 
[assembly: ComVisible(true)] 


编译 工程 。 
9.3.4 注册 自 定义 服务 器 对 象 扩展 


自 定义 服务 器 对 象 扩展 组 件 必须 进行 两 类 注册 。 一 类 是 程序 集 必须 在 使 用 计算 机 上 使 
用 .NET\COM 注册 。 另 一 类 是 必须 在 ArcGIS 服务 器 上 注册 服务 器 对 象 扩展 。 
通过 前 面 的 代码 ， 创 建 了 三 个 .NET 程序 集 。 


O VegSOECSharp.dll 一 一 包含 了 服务 器 对 象 扩展 类 及 业务 逻辑 ; 
口 VegSOEInterfacesCSharp.dll 一 一 包含 了 服务 器 对 象 扩展 实现 的 接口 ; 
O VegSOEPropsCSharp.dll 一 一 包含 配置 服务 器 对 象 扩 展 的 属性 页 。 


图 9.9 阐述 了 哪些 应 用 程序 或 进程 访问 哪些 组 件 。 要 注意 的 是 ，SOM 运行 的 计算 机 不 需要 访 
问 本 实例 创建 的 自 定义 组 件 ， 但 是 需要 在 该 计算 机 上 注册 自 定义 服务 器 对 象 扩展 。 


ArcCatalog 


egSOEPropsCSharp.dll 


.NET Client Application 


SOM 
'egSOEInterfacesCSharp.dll 
'egSOEInterfacesCSharp.dll 


图 9.9 各 组 件 应 该 分 布 的 计算 机 


VegSOE 程序 需要 在 所 有 服务 器 对 象 容器 计算 机 (ArcSOC.exe) 上 注册 。ArcSOC.exe 是 COM 
客户 端 ， 可 以 访问 其 他 COM 对 象 与 类 型 。 打 开 Visual Studio 2005 命令 行 工 具 ， 切 换 到 
VegSOECSharp.dll 所 在 的 目录 ， 使 用 如 下 命令 注册 : 

regasm VegSOE.dll /codebase 


VegSOEInterfaces 程序 集 定义 了 服务 器 对 象 扩展 的 接口 , 因此 也 需要 在 所 有 服务 器 对 象 容器 计 
算 机 上 注册 。 注 册 命令 如 下 : 


regasm VegSOEInterfaces.dll /tlb:VegSOEInterfacesCSharp.tlb 


regasm 工具 从 程序 集中 读 取 元 数据 。 由 于 程序 集 只 包含 接口 类 型 ， 因 此 必须 使 用 /tb 选项 生成 一 类 
型 库 。 
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VegSOEProps 程序 集 必须 在 ArcCatalog 运行 的 计算 机 上 注册 。 注 册 命 令 如 下 : 


regasm VegSOEPropsCSharp.dll /codebase 


9.35 ÆGIS 服务 器 上 注册 服务 器 对 象 扩展 


服务 器 对 象 扩展 需要 在 ArcGIS 服务 器 上 注册 ， 特 别 是 需要 在 服务 器 对 象 管理 器 中 注册 。 需 要 
使 用 ESRI.ArcGIS.Server 程序 集中 的 ArcObjects 组 件 ， 将 服务 器 对 象 扩展 可 访问 性 与 属性 等 信息 ， 
加 入 到 ArcGIS 服务 器 的 配置 文件 中 。 

在 解决 方案 中 创建 一 个 名 为 RegisterSOE 的 控制 台 类 型 的 工程 。 并 在 工程 中 加 入 
ESRLArcGIS.ADF.Connection 与 ESRLArcGIS.Server 程序 集 的 引用 。 

打开 Program.cs 文件 ， 在 其 中 加 入 如 下 命名 空间 的 引用 : 

using ESRI.ArcGIS.ADF.Connection.AGS; 


using ESRI.ArcGIS.Server; 
在 Main 方法 中 加 入 如 下 代码 : 


AGSServerConnection gisconnection = new AGSServerConnection(); 

gisconnection.Host - "localhost"; 

gisconnection.Connect () ; 

IServerObjectAdmin2 soa = 
(IServerObjectAdmin2)gisconnection.ServerObjectAdmin; 

IServerObjectExtensionType soet = soa.CreateExtensionType(); 


上 述 代 码 创建 了 一 个 AGSServerConnection 类 的 实例 ， 用 于 初始 化 与 SOM 的 连接 。 然 后 指定 
SOM 运行 计算 机 的 名 称 或 IP 地 址 ， 建 立 连 接 ， 并 利用 IServerObjectAdmin2 接口 创建 一 个 扩展 类 

需要 设置 新 建 扩展 类 型 的 属性 。 所 有 属性 都 使 用 字符 串 定义 。 在 Main 方法 中 再 加 入 如 下 代码 : 

sSoet.CLSID = "VegSOE.VegUtilsSOE"; 

soet.Description - "Veg Utilities Server Object Extension"; 

soet.Name = "VegUtilitiesSOE"; 

一 旦 设置 好 服务 器 对 象 扩展 的 属性 ， 可 以 使 用 IServerObjectAdmin2 接口 的 AddExtensionType 
方法 ， 将 其 加 入 到 一 服务 器 对 象 类 中 。 代 码 如 下 : 

Soa.AddExtensionType ("MapServer", soet); 

Console.WriteLine ("在 ArcGIS 服务 器 上 注册 服务 器 对 象 扩展 成 功 ") ; 

Console.ReadLine(); 

编译 并 运行 RegisterSOE 工程 。 如 果 注册 成 功 ， 将 在 控制 台 窗 口中 显示 “在 ArcGIS 服务 器 上 
注册 服务 器 对 象 扩展 成 功 ” 一 行文 本 信息 。 

在 服务 器 对 象 管理 器 计算 机 的 ArcGIS 安装 目录 下 的 server\system 路 径 中 ， 存 在 名 为 
ServerTypeExt.dat 的 文件 。 注 册 后 ， 会 在 该 文件 中 加 入 如 下 内 容 : 

<types> 


<ServerObjectType> 
<Name>MapServer</Name> 
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XExtensionTypes» 
XExtensionType» 
XName»VegUtilitiesSOE CSharp</Name> 
«DisplayName»«/DisplayName» 
X«CLSID»VegSOECSharp.VegUtilsSOE«/CLSID» 
«Description»Veg Utilities Server Object Extension 
«/Description» 
«/ExtensionType» 
«/ExtensionTypes» 
«/ServerObjectType» 
«/types» 


9.3.6 在 地 图 服务 上 应 用 服务 器 对 象 扩展 


配置 地 图 服务 应 用 服务 器 对 象 扩展 最 简单 的 方法 是 使 用 ArcCatalog。 

打开 ArcCatalog, 创建 一 个 与 ArcGIS 服务 器 的 管理 连接 。 打开 Yellowstone 地 图 服务 的 属性 配 
置 对 话 框 ， 切 换 到 Capabilities 选项 卡 中 。 选 择 VegUtilitiesSOE 扩展 。 在 该 选项 卡 的 Properties 部 
分 ， 将 图 层 属 性 设置 为 Vegetation， 字 段 属 性 设置 为 PRIMARY 。 设 置 如 图 9.10 所 示 。 


General | Parameters Capabilities | Posing | Processes | Caching | 
TV. Enable Web access 


ey 


[Moble Data Access. aj 


na. 
DInetwork Analysis 
` D 


Properties 一 一 一 


Select the layer and summary field for the extension. 


Lx ] c ES 
图 9.10 在 地 图 服务 上 应 用 服务 对 象 扩 展 


9.3.7 在 Web 应 用 程序 中 访问 服务 器 对 象 扩展 
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在 解决 方案 中 增加 名 为 VegSOEWebApp 的 Web 站 点 。 
在 Default.aspx 页 面 中 加 入 一 地 图 资源 管理 器 控件 、 一 地 图 控件 、 一 工具 栏 控件 、 一 Toc 控件 、 
一 标签 控件 、 一 文本 框 控件 、 一 复 选 框 控 件 、 一 IMG 控件 以 及 一 个 Div 控件 ， 并 在 Div 控件 中 加 
入 一 个 GridView 控件 。 在 地 图 资源 管理 器 控件 中 加 入 Yellowstone 地 图 资源 。 在 工具 栏 控件 中 加 
入 “放大 ”、“ 缩 小 ”、“ 漫 游 ” 工具 以 及 一 个 自 定义 工具 。 该 页 面 设 计 期 间 的 视图 完全 同 于 9.2.3 
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节 的 COMTest 的 Default.aspx 页 面 。 
在 Default.aspx 页 面 的 <head> 与 </head> 部 分 ， 加 入 如 下 JavaScript 内 容 ， 用 于 获取 用 户 在 文本 
框 与 复 选 框 提供 的 值 : 
<script language="javascript" type="text/javascript"> 
function SetCheckBox(id) { 
if (id == 'CheckBox1') 
{ 
document.getElementById('CheckBox1').value = ""; 
document.getElementById('CheckBox1').value = 
document.getElementById('CheckBox1') . checked; 


} 


function CustomLoad() { 
var customform - document.forms[0]; 
var original value - 
customform.elements ["ESRIWebADFHiddenFields"].value; 
var new value = original value + ",TextBoxl,CheckBoxl"; 
customform.elements["ESRIWebADFHiddenFields"].value = new value; 
) 
</script> 
当 用 户 选 择 复 选 框 时 调用 SetCheckBox 函数 。CustomLoad 函数 用 于 修改 一 隐藏 的 文本 框 元 素 
CESRIWebADFHiddenFields) , Web ADF 用 该 元 素 在 浏览 器 端 存储 一 些 结果 
ESRIWebADFHiddenFields 文本 框 元 素 是 Web 页 面 在 运行 期 间 写 入 的 。 cite E au 5 4) 
的 页 面 中 一 组 元 素 的 id， 如 下 所 示 : 
<input type-"hidden" name-"ESRIWebADFHiddenFields" 
id-"ESRIWebADFHiddenFields" 
value-"maxx, maxy, minx, miny, coords, Mapl mode, control, 
Toolbarl Group current tool," /» 

?4 Web ADF 生成 一 回 发 (回调 或 整个 页 面 的 回 发 ) 时 ，display dotnetad£js 文件 中 的 
createClientPostBackQueryString 函数 对 隐藏 文本 框 中 的 元 素 id 进行 循环 ， 加 入 每 个 字段 的 参数 与 
值 。 为 充分 利用 该 功能 ， 我 们 在 其 中 加 入 文本 框 与 复 选 框 的 id。 在 自 定义 工具 的 实现 代码 中 将 解 
析 这 些 值 。 

CustomLoad 函数 需要 在 页 面 加 载 时 便 执行 , 因此 需要 设置 页 面 的 body 标签 的 代码 , 如 下 所 示 : 


<body onload="CustomLoad () "> 


在 工程 中 加 入 ESRIArcGIS.Server、ESRI.ArcGIS.ADF.ArcGISServer、ESRI.ArcGIS.Carto、 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer ~ ESRLArcGIS.System 、 ESRLArcGIS.Geometry 
与 ESRI.ArcGIS.Display 程序 集 的 应 用 。 

在 App Code 目录 下 加 入 名 为 vegTool 的 类 。 该 类 用 于 实现 自 定义 工具 ， 在 该 工具 中 调用 服 
务 器 对 象 扩展 计算 缓冲 区 范围 内 各 种 植被 的 面积 。 在 该 类 的 头 部 加 入 如 下 命名 空间 的 引用 : 


using ESRI.ArcGIS.ADF.Web.UI.WebControls; 
using ESRI.ArcGIS.ADF.Web.UI.WebControls.Tools; 
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using ESRI.ArcGIS.ADF.ArcGISServer; 

using ESRI.ArcGIS.ADF.Web.DataSources; 

using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 
using ESRI.ArcGIS.Carto; 

using ESRI.ArcGIS.Geodatabase; 

using ESRI.ArcGIS.Server; 

using ESRI.ArcGIS.Geometry; 

using VegSOEInterfaces; 


修改 VegTool 类 的 声明 代码 : 
public class VegTool : IMapServerToolAction 


利用 集成 开发 环境 的 自动 生成 代码 功能 ， 生 成 IMapServerToolAction 接口 实现 的 代码 框架 。 在 
ServerAction 方法 中 首先 加 入 如 下 代码 : 


ESRI.ArcGIS.ADF.Web.UI.WebControls.Map mapctrl = args.Control 
as ESRI.ArcGIS.ADF.Web.UI.WebControls.Map; 


System.Web.UI.Page page - mapctrl.Page; 

string cbxvalue - String.Empty; 

string tbxvalue - String.Empty; 

string callbackArgs - String.Empty; 
System.Collections.Specialized.NameValueCollection keyValColl - null; 


if (page.IsCallback) 
t 
callbackArgs = page.Request.Params["  CALLBACKP. E 
keyValColl = 
CallbackUtility.ParseStringIntoNameValueCollection(callbackArgs); 
) 


else 


{ 
keyValColl = page.Request.Params; 


tbxvalue = keyValColl["TextBox1"]; 

cbxvalue - keyValColl["CheckBox1"]; 

在 上 面 的 代码 中 ， 如 果 工 具 启 动 的 是 一 回调 ， 那 么 HTTP 请 求 中 的 _CALLBACKPARAM 2 
数 包含 一 参数 / 值 对 ， 如 果 启 动 的 是 一 整个 页 面 的 回 发， 那么 参数 / 值 对 包含 在 HTTP 请 求 中 。 

然后 在 方法 中 加 入 如 下 代码 ,用 于 获取 服务 器 上 下 文 以 及 将 屏幕 坐标 的 点 对 象 转换 为 地 图 坐标 
点 对 象 : 

MapFunctionality mapfunc = 

(MapFunctionality)mapctrl.GetFunctionality ("Yellowstone"); 
MapResourceLocal mapres = (MapResourceLocal)mapfunc.MapResource; 


IServerContext sc = mapres.ServerContextInfo.ServerContext; 
IMapServer mapserver = mapres.MapServer; 


PointEventArgs pargs = (PointEventArgs)args; 
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ESRI.ArcGIS.ADF.Web.Geometry.Point inpt = 
ESRI.ArcGIS.ADF.Web.Geometry.Point.ToMapPoint ( 

pargs.ScreenPoint, mapctrl.Extent, 
mapfunc.DisplaySettings.ImageDescriptor.Width, 
mapfunc.DisplaySettings.ImageDescriptor.Height); 

IPoint pt = (IPoint)sc.CreateObject ("esriGeometry.Point"); 

pt.X = inpt.X; 

pt-Y = inpt-Y; 


double distance = 0; 


if (!Double.TryParse(tbxvalue, out distance)) { 
distance - 10000; 
} 


接着 加 入 如 下 代码 : 


IServerObjectExtensionManager soext manager = mapserver 
as IServerObjectExtensionManager; 
IServerObjectExtension soext = soext manager.FindExtensionByTypeName 
("VegUtilitiesSOE"); 
IVegUtilsSOE vegutils = (IVegUtilsSOE)soext; 
IVegResultsSOE vegresults = vegutils.sumVegetationType (pt, distance); 


如 果 服 务 器 对 象 上 应 用 了 一 服务 器 对 象 扩 展 , 那么 可 以 通过 FindExtensionByTypeName 方法 返 
回 指定 注册 名 称 的 服务 器 对 象 扩展 的 引用 。 得 到 服务 器 对 象 扩展 后 ， 便 可 调用 其 中 的 方法 。 

然后 在 方法 中 加 入 如 下 高 亮度 绘制 选择 要 素 的 代码 : 

IGraphicElements comGraphics = vegresults.ResGraphics; 

GraphicElement[] proxyGraphics = (GraphicElement[]) 


ESRI.ArcGIS.ADF.ArcGISServer.Converter.ComObjectToValueObject ( 
comGraphics, sc, typeof (GraphicElement[])); 
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RgbColor rgb = new RgbColor(); 
rgb.Red = 155; 

rgb.Green - 0; 

rgb.Blue - 0; 

rgb.AlphaValue = 255; 


SimpleLineSymbol sls = new SimpleLineSymbol (); 

Sls.Style = ESRI.ArcGIS.ADF.ArcGISServer.esriSimpleLineStyle.esriSLSSolid; 
sls.Color = rgb; 

sls.Width 027 


[i 


foreach (ESRI.ArcGIS.ADF.ArcGISServer.PolygonElement pe in proxyGraphics) { 
SimpleFillSymbol sfs = (SimpleFillSymbol)pe.Symbol; 
sfs.Outline = sls; 


mapfunc.MapDescription.CustomGraphics = proxyGraphics; 
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统计 结果 显示 的 代码 如 下 : 


GridView gdview = (GridView)mapctrl.Page.FindControl ("GridView1l"); 
string showtable - "'hidden'"; 
Boolean displaydiv - false; 


if (!Boolean.TryParse(cbxvalue, out displaydiv)) ( 
displaydiv = false; 


if (displaydiv) ( 
IRecordSet rs - vegresults.Stats; 
ESRI.ArcGIS.ADF.ArcGISServer.RecordSet value rs = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ComObject 
ToValueObject(rs, sc, typeof(ESRI.ArcGIS.ADF.ArcGISServer.RecordSet)) as 
ESRI.ArcGIS.ADF.ArcGISServer.RecordSet; 
System.Data.DataTable datatable = 
ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer.Converter.ToDataTable( 
value rs); 


gdview.DataSource = datatable; 
gdview.DataBind(); 


string returnstring - null; 


using (System.IO.StringWriter sw = new System.IO.StringWriter()) ( 
HtmlTextWriter htw = new HtmlTextWriter (sw); 
gdview.RenderControl (htw); 
htw.Flush(); 
returnstring - sw.ToString(); 


CallbackResult cr - new CallbackResult("div", "griddiv", "innercontent", 
returnstring); 
mapctrl.CallbackResults.Add(cr); 


if (datatable.Rows.Count » 1) 
showtable = "'visible'"; 


) 
最 后 加 入 如 下 代码 ， 用 于 设置 Div 的 可 见 性 以 及 刷新 地 图 : 


object[] oa = new object [1]; 


string sa = "var griddiv = document.getElementById('griddiv');"; 
Sa += "griddiv.style.visibility = " + showtable + ";"; 
oa[0] = sa; 


CallbackResult crl = new CallbackResult (null, null, "javascript", oa); 
mapctrl.CallbackResults.Add(crl); 


if (mapctrl.ImageBlendingMode == ImageBlendingMode.WebTier) { 
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mapctrl.Refresh(); 


} 
else if (mapctrl.ImageBlendingMode == ImageBlendingMode.Browser) { 


mapctrl.RefreshResource (mapres.Name); 

} 

由 于 我 们 在 自 定义 工具 中 已 经 实现 了 查询 以 及 结果 显示 功能 ， 因 此 对 于 _Default 类 ， 要 实现 的 
功能 就 很 少 了 。 只 需要 在 其 Page Load 方法 中 加 入 如 下 代码 ， 设 置 复 选 框 的 客户 端 onclick 事件 响 
应 函数 : 

CheckBoxl.Attributes.Add("onclick", "ChangeCheckBoxValue()"); 


编译 并 运行 程序 。 该 Web 程序 的 界面 、 使 用 方式 与 结果 都 与 9.2.3 节 的 Web 程序 完全 相同 。 


GIS Web 服 务 的 应 用 与 创建 


ArcGIS 提供 了 两 种 类 型 的 Web 服务 创建 方法 ,分 别 是 GIS Web 服务 和 应 用 性 Web 服务 。 

GIS Web 服务 提供 了 一 种 将 ArcGIS 服务 器 对 象 (本 地 数据 源 ) 发布 为 ArcGIS Server Web 
服务 (远程 数据 源 ) 的 ESRI 标准 ，GIS Web 服务 不 用 于 开发 ， 通 常用 来 发 布 信息 和 提供 资 
源 。 应 用 性 Web 服务 是 基于 标准 Web 服务 建立 的 应 用 ， 需 要 开发 人 员 使 用 某 种 数据 源 进行 
开发 。 

通过 本 章 你 将 了 解 到 : 


10.1 GIS Web 服务 的 应 用 
10.2 ”应 用 性 Web 服务 的 创建 与 使 用 
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10.1 GIS Web 服务 的 应 用 


ArcMap 等 桌面 应 用 程序 可 以 直接 使 用 GIS Web 服务 的 资源 而 不 用 进行 任何 开发 ， 另 外 Web 
ADF 控件 和 公有 API 也 可 以 使 用 GIS Web 服务 资源 。 由 于 GIS Web 服务 基于 标准 Web 服务 ， 它 
可 以 作为 传统 Web 服务 来 使 用 ，ArcGIS Server 提供 了 SOAP API 进行 相关 的 开发 。 

可 以 通过 本 地 与 远程 两 种 方式 来 访问 ArcGIS Server 服务 。 在 应 用 程序 中 ， 本 地 连接 是 通过 
ArcObjects 来 连接 服务 器 对 象 管理 器 的 。 而 远程 连接 是 通过 本 地 对 象 连接 Web 服务 端点 。 本 地 对 
象 意味 着 是 本 地 开发 环境 (例如 .NET 或 Java) 管理 的 对 象 。 本 地 连接 使 用 ArcObjects API 与 SOAP 
API， 操 作 服务 ， 也 就 是 服务 器 对 象 与 服务 器 上 下 文 。 服 务 〈 服 务 器 对 象 ) 的 状态 的 改变 只 能 使 用 
ArcObjects API 来 实现 。 远 程 连接 只 能 使 用 SOAP API 来 操作 服务 ， 所 以 所 有 与 服务 的 交互 都 是 无 
状态 的 。 通 常 ， 在 客户 应 用 程序 中 ArcGIS Server 的 连接 可 以 总 结 如 下 ， 如 图 10.1 所 示 : 


d) 远程 连接 总 是 使 用 SOAP API， 使 用 Web 服务 端点 的 URL 定义 连接 。 远 程 连接 可 用 于 
局 域 网 内 部 的 应 用 ， 也 可 用 于 Intemet 网 外 部 的 应 用 。 

(2) 本 地 连接 通常 总 是 使 用 ArcObjects API， 也 可 以 使 用 SOAP API， 这 需要 根据 客户 应 用 程 
序 的 需要 决定 。 本 地 连接 只 能 用 于 局 域 网 内 部 的 应 用 。 


Internet 


Client 
Application 


Internet ——3» 
Local ——» 


图 10.1 本 地 连接 与 远程 连接 的 区 别 


在 桌面 应 用 程序 中 ， 例 如 ArcMap、ArcCatalog 与 ArcGIS Explorer， 可 以 使 用 两 种 类 型 的 连接 
访问 事先 创建 的 ArcGIS Server 服务 。Web ADF 与 ArcGIS Server 管理 器 也 不 需要 显 式 定义 使 用 的 
API， 便 可 以 使 用 ArcGIS Server 服务 。 对 于 应 用 程序 开发 人 员 必 须 清楚 ArcGIS Server 服务 的 功能 
与 限制 。 因 此 , 使 用 SOAP API 需要 开发 人 员 掌握 一 定 的 Web 服务 标准 与 规范 , 以 及 ArcGIS Server 
服务 的 功能 。 

.NET 或 Java 开发 环境 都 提供 了 SOAP 工具 , 创建 本 地 的 值 对 象 以 及 代理 类 。WSDL 提供 了 创 
建 代理 类 与 值 对 象 需要 的 所 有 信息 。 客 户 应 用 程序 从 服务 器 得 到 WSDL， 创 建 代 理 类 与 值 对 象 的 
过 程 如 图 10.2 所 示 。 
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图 10.2 ”从 服务 器 中 获取 WSDL 并 创建 代理 类 与 值 对 象 的 过 程 


值 对 象 是 存储 值 与 属性 的 简单 对 象 。 根 据 WSDL， 可 以 是 许多 不 同类 型 的 值 对 象 。 另 一 方面 ， 
每 个 SOAP 服务 类 型 只 有 一 个 代理 类 。 代 理 类 同时 包含 属性 与 方法 。 方 法 用 于 创建 与 提交 SOAP 
请 求 ， 并 返回 SOAP 响应 。 代 理 类 使 用 值 对 象 来 创建 (序列 化 ) SOAP 请 求 。 代 理 类 同时 也 反 序 列 
化 SOAP 响应 ， 构 造 值 对 象 ， 如 图 10.3 所 示 。 因 此 ， 在 富 客 户 端 (Rich Client) 对 象 的 环境 中 ， 由 
于 使 用 本 地 值 对 象 存储 属性 并 管理 SOAP 请 求 与 响应 ， 使 用 SOAP 服务 相对 要 容易 得 多 。 


Client Application Server Application 


图 10.3 序列 化 请 求 与 反 序列 化 响应 


对 于 使 用 SOAP API 访问 ArcGIS Server Web 服务 的 开发 人 员 ， 根 据 连 接 类 型 与 客户 端 组 件 ， 
可 以 使 用 两 种 方法 开发 ArcGIS Server 应 用 程序 ， 如 图 10.4 所 示 。 


ArcGIS Server Web service 
Client Application | proxy 


图 10.4 通过 SOAPAPI 访 问 Web 服务 的 两 种 方式 
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如 果 可 以 使 用 Web ADF， 则 可 使 用 ESRLArcGIS.ADF.ArcGISServer 程序 集中 事先 创建 的 
ArcGIS SOAP 代理 类 与 值 对 象 。 对 于 支持 SOAP 的 每 个 服务 器 类 型 , 提供 了 两 个 代理 , 分 别 是 Web 
服务 代理 与 DCOM 代理 。Web 服务 代理 使 用 基于 HTTP 的 SOAP 访问 ArcGIS Server Web 服务 。 
DCOM 代理 使 用 基于 DCOM 的 SOAP, 通过 IRequestHandler 接 口 访问 服务 器 对 象 ,因此 需要 ArcGIS 
Server 本 地 连接 。 在 这 两 种 情况 下 ， 代 理 类 使 用 的 值 对 象 在 同一 类 库 与 命名 空间 中 。 

如 果 不 能 使 用 Web ADF， 则 可 使 用 NET 开发 包 中 的 SOAP 工具 ， 从 ArcGIS Server 的 Web 服 
务 端点 ， 生 成 Web 服务 的 代理 类 与 值 对 象 。 由 于 在 客户 端 没有 ArcObjects COM 代理 类 ， 因 此 不 能 
访问 远程 的 COM 对 象 ， 所 以 也 就 不 能 使 用 基于 DCOM 的 SOAP。 使 用 这 种 方式 ， 不 需要 在 客户 
端 安 装 任何 ESRI 的 产品 。 

对 于 ArcGIS Server 的 .NET 版 本 ,ArcGIS Server Web 服务 就 是 一 ASPNET Web 应 用 程序 , 包 
含 了 一 HTTP 处 理 程序 。HTTP 处 理 程序 内 部 使 用 IServiceCatalogAdmin 与 IRequestHandler 接口 向 
外 提供 基于 HTTP 的 SOAP API。ArcGIS Server Web 服务 应 用 程序 , 管理 通过 ArcObjects 与 SOAP 
API 的 交互 , 因此 开发 人 员 不 需要 使 用 ArcObjects。 这 意味 着 客户 端 不 需要 ArcObjects COM. 代理 。 
事实 上 ， 使 用 ArcGIS Server Web 服务 的 客户 端 不 需要 安装 ESRI 软件 。 

ArcGIS Server Web 服务 使 用 如 下 格式 的 URL: 

http://<Web Server Hostname>/<ArcGIS Instance>/services/<ServiceName>/<ServiceType> 


口 <Web Server Hostname> 是 Web 服务 应 用 程序 发 布 的 Web 服务 器 的 主机 名 或 IP 地 址 ; 

O ”<ArcGIS Instance> 是 包含 一 系列 服务 的 虚拟 路 径 的 名 称 。 每 个 服务 器 对 象 管理 器 有 一 个 名 
称 ， 在 ArcGIS Server 后 安装 过 程 中 指定 的 名 称 ; 

口 <ServiceName> 是 某 一 ArcGIS Server 服务 的 名 称 ; 

O <ServiceType> 是 服务 器 对 象 或 服务 器 对 象 扩展 类 型 。ArcGIS Server 包含 了 一 组 标准 的 服 
务 类 型 ， 例 如 MapServer、GeocodeServer 等 。 每 个 类 型 必须 提供 一 WSDL， 并 实现 
IRequestHandler 接口 。 


服务 器 对 象 或 扩展 的 WSDL 提供 了 通过 SOAP 与 Web 服务 访问 的 必要 信息 。 在 服务 的 URL 
后 加 上 “?wsdl” 可 访问 服务 器 对 象 或 扩展 的 的 WSDL。 

每 个 服务 类 型 有 一 代理 类 。SOAP 代理 定义 了 ArcGIS Server 服务 的 功能 。 正如 前 面 所 介绍 的 ， 
SOAP API 与 服务 交互 是 无 状态 的 ， 因 此 代理 类 提供 方法 初始 化 对 服务 的 无 状态 的 请 求 并 返回 结 
Ro SOAP 代理 的 功能 反映 了 服务 器 对 象 实现 的 无 状态 的 ArcObjects 接口 。 例 如 , MapServer SOAP 
代理 中 的 方法 同 于 ArcObjects MapServer 对 象 实现 的 无 状态 ArcObjects 接口 (TMapServer 与 
ITiledMapServer) 的 方法 。ArcGIS Server SOAP 代理 调用 方法 与 返回 结果 时 ， 使 用 值 对 象 。 因 此 ， 
SOAP 值 对 象 与 ArcObjects 类 型 使 用 相同 名 称 的 方法 , 但 是 不 同 的 对 象 类 型 。 值 对 象 是 本 地 的 .NET 
对 象 ， 而 服务 器 对 象 接口 引用 的 是 在 GIS 服务 器 上 的 COM 对 象 。 例 如 ，MapServer SOAP 代理 与 
IMapServer ArcObjects 接口 都 包含 名 为 ExportMapImage 方法 。 但 是 ，SOAP 代理 需要 两 个 输入 参 
数 ， 分 别 是 MapDescription 与 ImageDescription 类 型 的 NET 对 象 ， 而 IMapServer ArcObjects 接口 
要 求 的 两 个 参数 分 别 是 IMapDescription 与 IMageDescription 接口 引用 的 在 GIS 服务 器 上 的 COM 对 
象 .MapServer 代 理 返 回 一 个 本 地 的 NET 的 MapImasge 值 对 象 , 而 IMapServer 返 回 的 是 一 IMapImage 
接口 引用 的 在 GIS 服务 器 上 的 COM 对 象 。 

Web ADF 同时 包含 了 通过 Internet (Web 服务 ) 以 及 本 地 (DCOM) 连接 的 SOAP 代理 类 。NET 
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提供 了 SOAP 工具 包 wsdl.exe， 用 于 根据 一 WSDL 创建 代理 类 与 值 对 象 。 
下 面 的 代码 演示 了 如 何 利 用 SOAP 代理 类 初始 化 ArcGIS Server 地 图 服务 。 


CD 通过 Web 服务 代理 实现 ， 代 码 如 下 : 


string endpoint = 
"http://MyWebServer/arcgis/services/MyMapServiceName/MapServer"; 
ESRI.ArcGIS.ADF.ArcGISServer.MapServerProxy mapserver = 
new ESRI.ArcGIS.ADF.ArcGISServer.MapServerProxy (endpoint); 
(2) 通过 DCOM 代理 (需要 ESRLArcGIS.ADF.dll 与 ESRLArcGIS.ADF.Connection.dll 连接 
程序 集 ) 实现 ， 代 码 如 下 : 
ESRI.ArcGIS.ADF.Identity id = new ESRI.ArcGIS.ADF.Identity (username, password, 
domain); 


ESRI.ArcGIS.ADF.ArcGISServer.MapServerDcomProxy mapserver dcom = 
(MapServerDcomProxy) MapServerDcomProxy.Create (SOMname, servicename, id); 


// 通过 DCOM 代理 调用 方法 


mapserver dcom.Dispose(); 
G) 动态 实现 ， 代 码 如 下 : 


wsmap.AMapServiceName MapServer mapserver = 
new wsmap.AMapServiceName MapServer (); 
mapserver.Url = 
"http://MyWebServer/arcgis/services/MyMapServiceName/MapServer"; 
对 于 ArcGIS Server 服务 ， 只 需要 针对 每 种 服务 类 型 生成 一 次 代理 类 与 值 对 象 。 一 旦 生成 了 代 
理 类 与 值 对 象 , 即使 代理 类 名 称 中 包含 了 原 服务 的 名 称 , 也 可 用 于 访问 其 他 同类 型 的 ArcGIS Server 
Web 服务 。 


下 面 我 们 通过 一 个 实例 来 演示 如 何 使 用 ArcGIS Server Web 服务 目录 以 及 MapServer Web HR 
务 。 

在 Visual Studio 中 创建 一 个 名 为 MapServerBrowser 的 Windows 应 用 程序 。 

要 在 应 用 程序 中 访问 Web 服务 目录 以 及 MapServer Web 服务 提供 的 方法 与 对 象 ， 需 要 在 应 用 
程序 中 加 入 它们 的 Web 引用 。 

在 解决 方案 浏览 器 中 ， 选 择 工程 右键 菜单 的 Add Web Reference 命令 ， 打 开 如 图 10.5 所 示 的 
Add Web Reference 对 话 框 。 在 该 对 话 框 的 URL 文本 框 中 输入 Web 服务 目录 的 WSDL 地 址 ， 即 

“http://localhost/arcgis/services?wsdl”, 然后 回 车 , 或 选择 Go. 一旦 找到 Web 服务 , 在 Web reference 

name 文本 框 中 输入 WebCatalog, 然后 选择 Add Reference。 集成 开发 环境 将 利用 SOAP 工具 包 创 建 
该 Web 服务 的 代理 类 与 值 对 象 。 
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Add Web Reference 


Navigate to a web service URL and click Add Reference to add all the available services. 
Ora 0 Aad 


WL: [http://1ocslhost/arcgi s/ services?wsdl 司 ge 


PRIM x Web services found at this URL: 
Catalog" Description 1 Service Frud: 
- services 
| Methods 
a GetMessageFormats ( ) As esriServiceCatalogMessageFormat 
a GetServerVersion ( ) As esrircGISVersion 
1» GetServiceDescriptions ( ) As ArrayOfServiceDescription E——————————— 
Teb reference pane: 
YebCatalog 


图 10.5 Add Web Reference 对 话 框 


通过 同样 的 方式 ， 生 成 http://localhost/arcgis/services/NorthAmericaMap/MapServer?wsdl 
CNorthAmericaMap 地 图 服务 ) URL 地 址 的 Web 引用 ， 将 名 称 命名 为 NorthAmericaMapWS。 
这 时 可 在 解决 方案 浏览 器 中 发 现 新 增加 了 一 个 名 为 Web References 的 文件 夹 。 在 该 文件 中 包 
含 了 WebCatalog 与 NorthAmericaMapWS 两 Web 引用 。 双击 其 中 一 个 , 打开 对 象 浏览 器 , 如 图 10.6 
所 示 ， 可 以 查看 其 中 的 方法 。 


Forml. cs [Design] | Start Page Übject Browser| | 


Browse: All Components 


日 MapServerBrowser ^ 
四 {} NapServerBrowser 

{} MapServerBrowser. NorthAmericallaphs 3 

田 g F 

由 各 Background 

由 -名 BalloonCallout 

H&G BezierCurve 

四 4$ Border 

田代 Callout 

由 $ CartographicllarkerSynbol 

E Å$ CharacterllarkerSymbol 

E $ CircleElement 

由 -名 CircularÀrc 

E R CnykColor 

由 .各 Codedyalue 

G3 CodedValueDonain 

E- Coler 

由 f$ ConputeDi stanceConpletedEventArgs 

E- j ComputeDi stanceCompletedEventHandler 


图 10.6 通过 对 象 浏览 器 查看 类 及 其 方法 
加 入 Web 服务 的 引用 后 ,我 们 便 可 使 用 其 中 的 类 与 方法 ,访问 与 操作 ArcGIS Server Web 服务 。 
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在 Forml 窗 体 中 加 入 四 个 标签 控件 、 三 个 下 拉 列 表 框 空间 、 一 文本 框 控件 、 一 按钮 控件 、 一 
图 片 框 〈PictureBox) 控件 与 一 工具 条 (ToolStrip) 控件。 

通过 工具 条 控件 的 Iems 属性 , 打开 Items Collection Editor 对 话 框 。 在 该 对 话 框 中 加 入 “放大 ”、 
“缩小 ”、“ 全 图 ”与 “漫游 ”工具 ， 如 图 10.7 所 示 。 


Items Collection Editor 


Select item and add to list below: ToolStripButton tbPan 
(ab) Button | 


ES 


Henbers: CheclState Unchecked 


[5E toolStrip DisplayStyle Inage 
(S) tbzoomIn B) Font SinSun, 9pt 
国 tbZoonDut ForeColor | ES 
(E) tbFullExt El Insee 47] System. Drawing. 1 


n E 


ImageScaling SizeToFit 
ImageTransparentColo [iii] magenta 
RightToLeft No 
RightToLeftÀutolirro False 

Text tbPan 
TextAlign WiddleCenter 
TextDirection Horizontal 
TextImageRelation ImageBeforeText 


Cancel 


图 10.7 通过 Items Collection Editor 对 话 杠 加 入 工具 


Forml 窗 体 在 设计 期 间 的 视图 如 图 10.8 所 示 。 


Web 服 务 目录 URL : 获 职 Web 服 务 | 


MapServer Web 服 务 
Sek: 


Fd10.8 Hi% Formi 的 设计 视图 


切换 到 Forml.cs 的 代码 文件 中 ， 首 先 在 类 中 加 入 如 下 字段 : 


private string m sSelectedMap; 

private NorthAmericaMapWS.MapDescription m sMapDesc; 
private string m sDataFrame; 

private double startX; 
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private double startY; 

private int startDragX; 

private int startDragY; 

private int deltaDragX; 

private int deltaDragY; 

private NorthAmericaMapWS.ImageDisplay idisp; 
private System.Drawing.Image plmage; 

private Boolean ispanning; 


创建 按钮 的 Click 事件 响应 方法 。 在 该 方法 中 ， 需 要 完成 连接 Web 服务 目录 ， 得 到 一 组 
MapServer Web 服务 ， 并 加 入 到 Web 服务 下 拉 列 表 框 。 

由 于 需要 跨 进程 SOAP 调用 ， 该 操作 可 能 需要 花费 几 秒 时 间 来 执行 ， 因 此 需要 在 应 用 程序 中 
向 用 户 显 示 正 在 运行 的 状态 。 这 可 以 通过 显示 一 个 等 待 光标 来 实现 。 在 按钮 的 Click 事件 响应 方法 
中 首先 加 入 代码 : 


this.Cursor = Cursors.WaitCursor; 
cboMapServer.Items.Clear(); 


然后 加 入 如 下 代码 ， 实 现 查 询 : 


try ( 
WebCatalog.Catalog sc = new WebCatalog.Catalog(); 
Sc.Url = txtServer.Text; 
WebCatalog.ServiceDescription[] wsdesc = sc.GetServiceDescriptions(); 
WebCatalog.ServiceDescription sd - null; 
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for (int i = 0; i < wsdesc.Length; i++) ( 
sd = wsdesc[i]; 
if (sd.Type -- "MapServer") ( 
cboMapServer.Items.Add(sd.Url); 
) 
) 


cboMapServer.Enabled - true; 
this.Cursor = Cursors.Default; 
) 
catch (Exception exception) { 
this.Cursor = Cursors.Default; 
MessageBox.Show(exception.Message, "An error has occurred"); 


) 


在 上 述 代码 中 ， 首 先 创 建 一 个 WebCatalog.Catalog 对 象 ， 然 后 设置 该 对 象 的 URL， 然 后 调用 
该 对 象 的 GetServiceDescriptions 方法 ， 得 到 ServiceDescription 对 象 数组 。 然 后 通过 一 个 循环 得 到 
MapServer Web 服务 的 URL， 并 加 入 到 Web 服务 下 拉 列 表 框 CcboMapServer) 中 。 

下 面 要 实现 的 是 得 到 指定 的 地 图 服务 的 数据 集 名 称 数组 。 

创建 Web 服务 下 拉 列 表 框 (cboMapServer) 的 选择 索引 改变 CSelectedIndexChange) 事件 的 响 
应 方法 。 在 其 中 加 入 如 下 代码 : 

m sSelectedMap = cboMapServer.Text; 

try ( 
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NorthAmericaMapWS.NorthAmericaMap MapServer map = 
new NorthAmericaMapWS.NorthAmericaMap MapServer (); 
map.Url = m sSelectedMap; 


m sDataFrame = map.GetDefaultMapName (); 


// 得 到 数据 集 名 称 ， 并 填充 到 下 拉 列 表 框 中 

cboDataFrame.Items.Clear(); 

for (int i = 0; i < map.GetMapCount(); i++) ( 
cboDataFrame.Items.Add (map.GetMapName (i)); 

) 


cboDataFrame.Text = m sDataFrame; 


// 控制 控件 的 状态 
cboDataFrame.Enabled = true; 
cboBookMark.Enabled - true; 
IEnumerator benum = toolStripl.Items.GetEnumerator(); 
ToolStripButton btn - null; 
while (benum.MoveNext()) ( 
btn = (ToolStripButton)benum.Current; 
btn.Enabled = true; 


) 
catch (Exception exception) { 
MessageBox.Show(exception.Message, "An error has occurred"); 


) 


在 上 面 的 方法 中 ， 首 先 创建 一 个 地 图 服务 器 实例 ， 然 后 调用 其 GetDefaultMapName 方法 得 到 
当前 选择 的 数据 集 的 名 称 。 然 后 通过 循环 ， 将 地 图 中 的 数据 集 名 称 加 入 到 数据 集 下 拉 列 表 杠 
CcboDataFrame) 中 。 

下 面 要 实现 的 是 响应 数据 集 改 变 的 代码 。 创 建 数据 集 下 拉 列 表 框 (cboDataFrame) 的 选择 索引 
改变 (SelectedIndexChanged) 事件 响应 方法 。 在 其 中 加 入 如 下 代码 : 


m sDataFrame = cboDataFrame.Text; 


try { 
// 从 地 图 服务 器 查询 选择 的 数据 集 的 信息 
NorthAmericaMapWS.NorthAmericaMap MapServer map = 
new NorthAmericaMapWS.NorthAmericaMap MapServer(); 
map.Url - m sSelectedMap; 


// 得 到 书签 ， 并 填充 书签 下 拉 列 表 框 


NorthAmericaMapWS.MapServerInfo mapi = map.GetServerInfo(m sDataFrame); 
NorthAmericaMapWS.MapServerBookmark[] pMSBookMarks = mapi.Bookmarks; 


cboBookMark.Items.Clear(); 

cboBookMark.Items.Add("«Default Extent»"); 

NorthAmericaMapWS.MapServerBookmark pMDBook; 

for (int j = 0; j < pMSBookMarks.Length; j++) { 
pMDBook = pMSBookMarks[jl; 
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cboBookMark.Items.Add (pMDBook.Name) ; 


) 
cboBookMark.SelectedItem = "«Default Extent»"; 


} 
catch (Exception exception) { 
MessageBox.Show (exception.Message, "An error has occurred"); 


} 


在 上 面 的 代码 中 ， 首 先 创 建 一 个 地 图 服务 器 对 象 ， 并 设置 该 对 象 的 Url 属性 ， 然 后 调用 其 
GetServerInfo 方法 得 到 指定 数据 集 的 MapServerInfo 对 象 ， 从 该 对 象 中 得 到 一 个 空间 书签 数组 。 然 
后 利用 一 个 循环 ， 将 书签 的 名 称 加 入 到 数据 下 拉 列 表 框 中 。 

前 面 的 代码 是 通过 Web 服务 目录 以 及 MapServer Web 服务 的 方法 ， 得 到 它们 的 信息 ， 并 填充 
到 下 拉 列 表 框 中 。 

下 面 要 完成 的 就 是 在 图 片 框 中 绘制 地 图 。 我 们 将 绘制 地 图 的 代码 封装 在 如 下 辅助 方法 中 : 


private void DrawMap (ref NorthAmericaMapWS.MapDescription pMapDescriptoin) 


该 方法 需要 的 参数 是 MapDescription 类 型 的 对 象 , 当 需 要 输出 地 图 时 , 地 图 服务 器 利用 该 地 图 
描述 对 象 中 的 属性 , 绘制 地 图 ,而 不 改变 运行 的 地 图 服务 器 对 象 。 这 些 属性 包括 绘制 的 范围 以 及 图 
层 的 可 见 性 等 。 可 见地 图 描述 的 目的 是 实现 无 状态 地 应 用 地 图 服务 器 , 因此 需要 在 应 用 程序 中 保存 
这 些 状态 的 信息 。 

在 DrawMap 方法 中 加 入 如 下 代码 : 

NorthAmericaMapWS.NorthAmericaMap MapServer map = 


new MapServerBrowser.NorthAmericaMapWS.NorthAmericaMap MapServer(); 
map.Url = m sSelectedMap; 


// 设置 输出 地 图 的 图 像 描 述 

NorthAmericaMapWS.ImageType it = new NorthAmericaMapWS.ImageType(); 

it.ImageFormat = NorthAmericaMapWS.esrilmageFormat.esrilmageJPG; 

it.ImageReturnType - 
NorthAmericaMapWS.esrilmageReturnType.esrilmageReturnMimeData; 


idisp = new NorthAmericaMapWS.ImageDisplay(); 
idisp.ImageHeight = 400; 

idisp.ImageWidth = 552; 

idisp.ImageDPI = 150; 


NorthAmericaMapWS.ImageDescription pID = 
new NorthAmericaMapWS.ImageDescription(); 
pID.ImageDisplay = idisp; 

pID.ImageType - it; 


NorthAmericaMapWS.MapImage pMI = map.ExportMapImage (pMapDescriptoin, pID); 
System.IO.Stream pStream = new System. IO.MemoryStream( (byte[])pMI.ImageData); 
plImage = Image.FromStream(pStream); 


pictureBoxl.Image = plmage; 
pictureBoxl.Refresh(); 
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在 上 面 的 代码 中 ， 首 先 创 建 一 地 图 服务 器 对 象 ， 并 指定 其 Url 属性 。 然 后 创建 一 个 图 像 描 述 对 
象 。 接 着 调用 地 图 服务 器 对 象 的 ExportMapImage 方法 绘制 地 图 , 并 将 其 转换 为 一 NET 的 图 像 对 象 。 


最 后 将 该 图 像 对 象 赋予 图 片 框 控件 。 


当 用 户 从 书签 下 拉 列 表 框 中 选择 一 个 书签 时 ， 图 片 框 控件 中 将 显示 选择 书签 的 范围 中 的 地 图 。 


创建 书签 下 拉 列 表 框 〈cboBookMark) 的 选择 索引 改变 事件 响应 方法 。 在 其 中 加 入 如 下 代码 : 


this.Cursor = Cursors.WaitCursor; 


try | 


) 


NorthAmericaMapWS.NorthAmericaMap MapServer map = 


new MapServerBrowser.NorthAmericaMapWS.NorthAmericaMap MapServer (); 


map.Url - m sSelectedMap; 


NorthAmericaMapWS.MapServerInfo mapi = map.GetServerInfo(m sDataFrame); 


NorthAmericaMapWS.MapDescription pMapDescription; 


// 如 果 选 择 默 认 的 范围 ， 则 从 地 图 描述 中 得 到 绘制 范围 

if (cboBookMark.Text == "«Default Extent»") ( 
pMapDescription = mapi.DefaultMapDescription; 
m sMapDesc - pMapDescription; 
DrawMap(ref pMapDescription); 
this.Cursor - Cursors.Default; 
return; 


) 
pMapDescription = m sMapDesc; 


// 查询 选择 的 书签 


NorthAmericaMapWS.MapServerBookmark[] pMSBookMarks = mapi.Bookmarks; 


NorthAmericaMapWS.MapServerBookmark pMDBook - null; 


for (int i = 0; i < pMSBookMarks.Length; i++) ( 
pMDBook = pMSBookMarks [i]; 
if (pMDBook.Name == cboBookMark.Text) 
break; 


) 


// 将 地 图 描述 的 范围 属性 设置 为 书签 的 范围 
NorthAmericaMapWS.MapArea pMA = pMDBook; 
pMapDescription.MapArea = pMA; 


// 保存 地 图 描述 
m sMapDesc = pMapDescription; 
DrawMap (ref pMapDescription); 


this.Cursor = Cursors.Default; 


catch (Exception exception) { 


this.Cursor - Cursors.Default; 
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} 


MessageBox.Show (exception.Message, "An error has occurred"); 


下 面 要 实现 的 就 是 “放大 ”、“ 缩 小 ”、“ 全 图 ”以 及 “漫游 ”工具 。 创 建 工具 条 控件 的 工具 


事件 (ItemClicked) 响应 方法 。 在 其 中 加 入 如 下 代码 框架 : 


switch(toolStripl.Items.IndexOf (e.ClickedItem)){ 


} 


case 0: // 放大 
break; 

case 1: // 缩小 
break; 

case 2: // 全 图 
break; 

case 3: // 漫游 


break; 


对 于 “放大 ”工具 ， 需 要 先 得 到 地 图 服务 对 象 ， 设 置 其 Url 属性 ， 从 m sMapDesc 中 得 到 当前 
地 图 描述 信息 , 缩小 其 范围 , 然后 调用 DrawMap 方法 绘制 地 图 ,最 后 使 用 新 的 范围 更 新 m_sMapDesc 


TH. 


代码 如 下 : 


this.Cursor = Cursors.WaitCursor; 
try { 


NorthAmericaMapWS.NorthAmericaMap MapServer map = 
new MapServerBrowser.NorthAmericaMapWS.NorthAmericaMap MapServer(); 
map.Url - m sSelectedMap; 


NorthAmericaMapWS.MapDescription pMapDescription - m sMapDesc; 


// 得 到 当前 范围 并 缩小 该 范围 ， 然 后 将 该 新 的 范围 设置 到 地 图 描述 对 象 中 
NorthAmericaMapWS.EnvelopeN pEnvelope = pMapDescription.MapArea.Extent 
as NorthAmericaMapWS.EnvelopeN; 


double eWidth = Math.Abs(pEnvelope.XMax - pEnvelope.XMin); 
double eHeight = Math.Abs (pEnvelope.YMax - pEnvelope.YMin); 
double xFactor = (eWidth - (eWidth * 0.75)) / 2; 

double yFactor = (eHeight - (eHeight * 0.75)) / 2; 
pEnvelope.XMax - pEnvelope.XMax - xFactor; 

pEnvelope.XMin = pEnvelope.XMin + xFactor; 

pEnvelope.YMax pEnvelope.YMax - yFactor; 

pEnvelope.YMin pEnvelope.YMin + yFactor; 


ll 


NorthAmericaMapWS.MapExtent pMapExtext = 
new NorthAmericaMapWS.MapExtent () ; 

pMapExtext.Extent = pEnvelope; 

pMapDescription.MapArea - pMapExtext; 


// 保存 地 图 描述 并 绘制 地 图 
m sMapDesc = pMapDescription; 
DrawMap (ref pMapDescription); 
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this.Cursor = Cursors.Default; 
} 
catch (Exception exception) 


t 
this.Cursor - Cursors.Default; 
MessageBox.Show(exception.Message, "An error has occurred"); 


} 
对 于 “缩小 ”工具 ， 代 码 基 本 与 放大 工具 一 致 ， 只 是 这 次 需要 扩大 范围 。 该 工具 的 代码 如 下 : 


this.Cursor = Cursors.WaitCursor; 
try { 
NorthAmericaMapWS.NorthAmericaMap MapServer map = 
new MapServerBrowser.NorthAmericaMapWS.NorthAmericaMap MapServer (); 
map.Url - m sSelectedMap; 


NorthAmericaMapWS.MapDescription pMapDescription - m sMapDesc; 


// 得 到 当前 范围 并 扩大 该 范围 ， 然 后 将 该 新 的 范围 设置 到 地 图 描述 对 象 中 
NorthAmericaMapWS .EnvelopeN pEnvelope = pMapDescription.MapArea.Extent 
as NorthAmericaMapWS.EnvelopeN; 


double eWidth = Math.Abs (pEnvelope.XMax - pEnvelope.XMin); 
double eHeight = Math.Abs(pEnvelope.YMax - pEnvelope.YMin); 
double xFactor = ((eWidth * 1.25) - eWidth) / 2; 

double yFactor = ((eHeight * 1.25) - eHeight) / 2; 
pEnvelope.XMax - pEnvelope.XMax * xFactor; 

pEnvelope.XMin - pEnvelope.XMin - xFactor; 

pEnvelope.YMax pEnvelope.YMax + yFactor; 

pEnvelope.YMin - pEnvelope.YMin - yFactor; 


NorthAmericaMapWS.MapExtent pMapExtext = 
new NorthAmericaMapWS .MapExtent () ; 

pMapExtext.Extent = pEnvelope; 

pMapDescription.MapArea = pMapExtext; 


// 保存 地 图 描述 并 绘制 地 图 
m sMapDesc = pMapDescription; 
DrawMap (ref pMapDescription); 


this.Cursor = Cursors.Default; 

) 

catch (Exception exception) { 
this.Cursor = Cursors.Default; 
MessageBox.Show(exception.Message, "An error has occurred"); 


h 
对 于 “全 图 ”工具 ， 


需要 做 的 是 将 地 图 的 整个 范围 设置 为 当前 范围 。 该 工具 的 代码 如 下 


this.Cursor = Cursors.WaitCursor; 
try ( 
NorthAmericaMapWS.NorthAmericaMap MapServer map = 
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new MapServerBrowser.NorthAmericaMapWS.NorthAmericaMap MapServer (); 
map.Url - m sSelectedMap; 
NorthAmericaMapWS.MapServerInfo mapi = map.GetServerInfo(m sDataFrame); 


NorthAmericaMapWS.MapDescription pMapDescription - m sMapDesc; 


// 得 到 地 图 的 整个 范围 ， 并 设置 为 当前 范围 
NorthAmericaMapWS.Envelope pEnvelope = mapi.FullExtent; 


NorthAmericaMapWS.MapExtent pMapExtext = 
new NorthAmericaMapWS.MapExtent(); 

pMapExtext.Extent = pEnvelope; 

pMapDescription.MapArea - pMapExtext; 


// save the map description and draw the map 
m sMapDesc = pMapDescription; 
DrawMap (ref pMapDescription); 


this.Cursor - Cursors.Default; 

) 

catch (Exception exception) 

d 
this.Cursor - Cursors.Default; 
MessageBox.Show(exception.Message, "An error has occurred"); 


) 
“漫游 ”工具 相对 要 复杂 一 些 ， 它 要 处 理 鼠 标的 一 些 操作 。 首 先 在 该 工具 中 加 入 如 下 代码 : 


ispanning = false; 
ToolStripButton btn = (ToolStripButton)e.ClickedItem; 
if (!btn.Checked) { 

ispanning - true; 

pictureBoxl.Cursor = Cursors.Hand; 


) 
else ( 

pictureBox1l.Cursor = Cursors.Default; 
) 


下 面 要 处 理 的 是 图 片 框 的 鼠标 按 下 事件 的 响应 。 首 先 创建 该 事件 的 响应 方法 , 在 其 中 加 入 如 下 


代码 : 


if (e.Button != MouseButtons.Left) 
return; 


// 判断 是 否 选择 了 漫游 工具 
IEnumerator benum = toolStripl.Items.GetEnumerator (); 
ToolStripItem btn = null; 
while (benum.MoveNext()) { 
btn = (ToolStripItem)benum.Current; 
if (toolStripl.Items.IndexOf(btn) == 3 && ispanning) { 
NorthAmericaMapWS.NorthAmericaMap MapServer map = new 
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MapServerBrowser.NorthAmericaMapWS.NorthAmericaMap MapServer (); 
map.Url = m sSelectedMap; 


NorthAmericaMapWS.MapDescription pMapDescription - m sMapDesc; 

int[] Xs = ( e.X ); 

intii Ys = { oY }; 

NorthAmericaMapWS.MultipointN mpnt = map.ToMapPoints (m sMapDesc, 
idisp, Xs, Ys) as NorthAmericaMapWS.MultipointN; 

NorthAmericaMapWS.Point[] pnta = mpnt.PointArray; 

NorthAmericaMapWS.PointN pnt = pnta[0] as NorthAmericaMapWS.PointN; 

startX = pnt.X; 

startY = pnt.Y; 

startDragX - e.X; 

startDragY - e.Y; 


} 
下 面 要 完成 的 是 图 片 框 的 鼠标 移动 事件 响应 方法 ， 该 方法 的 代码 如 下 : 


if (e.Button != MouseButtons.Left) 
return; 


IEnumerator benum = toolStripl.Items.GetEnumerator (); 
ToolStripItem btn = null; 
while (benum.MoveNext()) { 
btn = (ToolStripItem)benum.Current; 
if (toolStripl.Items.IndexOf(btn) == 3 && ispanning) ( 
// 拖 动 图 像 
pictureBoxl.Image = null; 
deltaDragX startDragX - e.X; 
deltaDragY = startDragY - e.Y; 
pictureBox1l.Invalidate(); 


) 

在 上 述 代码 中 ， 图 片 框 控件 的 Invalidate 方法 将 触发 该 控件 的 Pain 事件 。 该 该 事件 响应 方法 中 
要 实现 拖 动 图 像 的 功能 。 在 该 事件 响应 方法 中 加 入 如 下 方法 : 

// 得 到 图 像 


Image newlmage = plmage; 


if (newImage != null) { 

// 创建 显示 图 像 的 矩形 

Point loc = pictureBox1.Location; 

Rectangle destRect = new Rectangle (pictureBoxl.Left - loc.X - deltaDragX, 
pictureBoxl.Top - loc.Y - deltaDragY, 
pictureBox1.Width,pictureBox1.Height); 

// 在 屏幕 上 绘制 图 像 

e.Graphics.Drawlmage (newImage, destRect); 


} 
最 后 要 实现 的 是 图 片 框 的 鼠标 释放 事件 响应 。 在 该 事件 响应 方法 中 加 入 如 下 方法 : 
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if (e.Button != MouseButtons.Left) 
return; 


// is pan enabled? 

IEnumerator benum = toolStripl.Items.GetEnumerator (); 
ToolStripItem btn = null; 

while (benum.MoveNext()) { 


) 


btn 
if 


= (ToolStripItem)benum.Current; 

(toolStripl.Items.IndexOf (btn) == 3 && ispanning) { 

this.Cursor = Cursors.WaitCursor; 

NorthAmericaMapWS.NorthAmericaMap MapServer map = new 
MapServerBrowser.NorthAmericaMapWS.NorthAmericaMap MapServer (); 

map.Url = m sSelectedMap; 


NorthAmericaMapWS.MapDescription pMapDescription = m sMapDesc; 

int[] Xs = ( e.X ); 

nti Ve — env 

NorthAmericaMapWS.MultipointN mpnt = map.ToMapPoints (m sMapDesc, 
idisp, Xs, Ys) as NorthAmericaMapWS.MultipointN; 

NorthAmericaMapWS.Point[] pnta - mpnt.PointArray; 

NorthAmericaMapWS.PointN pnt - pnta[0] as NorthAmericaMapWS.PointN; 


double deltaX - pnt.X - startX; 
double deltaY pnt Y - starti; 


// 改变 范围 
NorthAmericaMapWS.EnvelopeN pEnvelope = 
pMapDescription.MapArea.Extent as NorthAmericaMapWS.EnvelopeN; 


pEnvelope.XMax = pEnvelope.XMax - deltaX; 
pEnvelope.XMin = pEnvelope.XMin - deltaX; 
pEnvelope.YMax = pEnvelope.YMax - deltaY; 
pEnvelope.YMin = pEnvelope.YMin - deltaY; 


NorthAmericaMapWS.MapExtent pMapExtext = 
new NorthAmericaMapWS.MapExtent (); 

pMapExtext.Extent = pEnvelope; 

pMapDescription.MapArea = pMapExtext; 


// 保存 地 图 描述 并 绘制 地 图 
m sMapDesc = pMapDescription; 
DrawMap (ref pMapDescription); 


deltaDragX = 0; 

deltaDragY 0; 
pictureBoxl.Invalidate(); 
this.Cursor - Cursors.Default; 


编译 并 运行 程序 。 在 Web 服务 目录 URL 中 输入 http://localhost/arcgis/services， 然 后 选择 “ 获 
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取 Web 服务 ”按钮 ， 将 在 Web 服务 下 拉 列 表 框 中 显示 GIS 服务 器 中 所 有 的 地 图 Web 服务 。 选 择 
其 中 一 个 地 图 服务 ， 便 可 在 图 片 框 中 显示 该 地 图 服务 的 地 图 。 通 过 “放大 ”、“ 缩 小 ”、“ 漫 游 ” 
按钮 浏览 地 图 。 程 序 运行 效果 如 图 10.9 所 示 。 


书签 : Default Extent? 


Web 服 务 目 录 URL : [http://1ocalhost/arcgis/serviced 
MapServer Web 服 务 
DER: 


图 10.9 程序 运行 效果 


10.2 ”应 用 性 Web 服务 的 创建 与 使 用 


今天 ， 越 来 越 多 的 GIS 系统 既 需 要 访问 其 他 系统 提供 的 Web 服务 ， 也 需要 向 其 他 系统 提供 空 
间 信 息 Web 服务 。 我 们 可 以 通过 将 ArcGIS Server 的 地 图 服务 再 次 封装 为 Web 服务 ， 对 其 他 提供 
更 具有 针对 性 的 、 调 用 更 简单 的 方法 。 

应 用 性 Web 服务 就 是 一 个 ASP.NET 的 Web 服务 ， 它 的 创建 方式 完全 同 于 ASP.NET 的 Web 
服务 的 开发 ， 只 是 其 中 的 代码 需要 调用 ArcGIS Server 的 服务 。 

下 面 我 们 通过 一 个 简单 的 实例 来 演示 如 何 创 建 与 使 用 应 用 性 Web 服务 。 


10.2.1 应 用 性 Web 服务 的 创建 


新 建 一 个 名 为 AmericaWebService 的 ASP.NET Web 服务 类 型 的 站 点 。 首 先 加 入 
ESRIArcGIS.ADF . — ESRLArcGIS.ADF.Connection 、 ESRIArcGIS.ADF.Connection.AGS 、 


\ 


(n) 
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ESRIArcGIS.ADF.Web.DataSources.ArcGISServer ESRLArcGIS.Geodatabase $ 
ESRI.ArcGIS.Geometry, ESRLArcGIS.Server 与 ESRLArcGIS.System 程序 集 的 引用 。 
在 解决 方案 管理 器 中 将 Service.asmx 更 名 为 QueryService。 并 在 该 类 的 头 部 加 入 如 下 命名 空间 


的 引用 : 


using ESRI.ArcGIS.esriSystem; 

using ESRI.ArcGIS.Server; 

using ESRI.ArcGIS.Geometry; 

using ESRI.ArcGIS.ADF.Connection.AGS; 

using ESRI.ArcGIS.Geodatabase; 

using ESRI.ArcGIS.ADF.Web.DataSources.ArcGISServer; 
using ESRI.ArcGIS.ADF; 

using ESRI.ArcGIS.Carto; 


由 于 我 们 需要 使 用 服务 器 上 下 文 ， 因 此 首先 加 入 得 到 该 服务 器 上 下 文 的 辅助 方法 。 代 码 如 下 : 


private IServerContext getServerContext () 


{ 


} 


string servername = "localhost"; 
string mapserverobject = "USAMap"; 
IServerObjectManager serverManager; 


// *** 使 用 Web ADF 公有 API 

Identity identity = new Identity("username", "password", null); 

AGSServerConnection gisconnection = new AGSServerConnection (servername, 
identity); 

gisconnection.Connect () ; 


serverManager - gisconnection.ServerObjectManager; 
IServerContext mapContext = 


serverManager.CreateServerContext (mapserverobject, "MapServer"); 
return mapContext; 


在 上 面 的 代码 中 ,我们 通过 AGSServerConnection 连接 对 象 ， 建 立 与 GIS 服务 器 的 连接 ， 然 后 
通过 CreateServerContext 方法 得 到 USAMap 地 图 服务 的 上 下 文 。 

然后 加 入 一 个 名 为 PointQuery 的 Web 方法 的 代码 框架 。 该 方法 用 于 实现 从 USAMap 地 图 服 
务 的 第 二 个 图 层 〈 即 美国 州 行政 图 层 ) 中 进行 点 查询 ， 并 返回 查询 到 的 州 的 名 称 : 


[WebMethod] 
public string PointQuery (double x, double y) 


{ 
} 


在 PointQuery 方法 中 ， 加 入 如 下 代码 : 


IServerContext serverContext = getServerContext () 
IMapServer mapServer - serverContext.ServerObject as IMapServer; 
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IMapServerInfo mapInfo - mapServer.GetServerInfo (mapServer.DefaultMapName); 
IMapDescription mapDesc - mapInfo.DefaultMapDescription; 


ISpatialFilter spatialFilter = 

serverContext.CreateObject ("esriGeodatabase.SpatialFilter" 

as ISpatialFilter; 
IPoint geometry - serverContext.CreateObject ("esriGeometry.Point") as IPoint; 
geometry.X — x; 
geometry.Y — y; 
spatialFilter.Geometry - geometry; 
spatialFilter.SpatialRel = esriSpatialRelEnum.esriSpatialRelIntersects; 
IRecordSet rs = mapServer.QueryFeatureData( 

mapDesc.Name, 1, (IQueryFilter)spatialFilter); 

if (rs == null) 

return ""; 
ICursor cursor - rs.get Cursor (true); 
IRow row = cursor.NextRow() as IRow; 
if (row == null) 

return ""; 


int fieldIndex = rs.Table.FindField("STATE NAME"); 
string stateName = row.get Value(fieldIndex).ToString(); 


// 释放 服务 器 上 下 文 


serverContext.ReleaseContext (); 


return stateName; 


在 PointQuery 方法 中 ， 首 先 调用 getServerContext 方法 得 到 服务 器 上 下 文 ， 从 该 上 下 文 对 象 的 


ServerObject 属性 中 得 到 地 图 服务 器 对 象 。 然 后 利用 服务 器 上 下 文 的 CreateObject 方法 创建 空间 查 
询 对 象 。 接 着 调用 地 图 服务 器 对 象 的 QueryFeatureData 方法 实现 空间 查询 。 最 后 返回 查询 结果 中 字 
段 为 STATE NAME 的 结果 。 


10.22 ”应 用 性 Web 服务 的 应 用 


询 : 


由 于 应 用 性 Web 服务 是 一 标准 的 ASP.NET Web 服务 ， 因 此 该 服务 的 应 用 很 简单 。 
新 增加 一 名 为 WebServiceTest 的 控制 台 。 加 入 10.2.1 节 创 建 的 Web 服务 的 Web 引用。 
在 Program 类 的 Main 方法 中 加 入 如 下 代码 ， 用 于 调用 Web 服务 的 PointQuery 方法 ， 实 现 查 


QueryService.QueryService service = new QueryService.QueryService(); 
string stateName = ""; 
try 
£ 
stateName = service.PointQuery(-111.6125, 35.912); 
Console.WriteLine ("查询 成 功 ， 查 询 结果 为 :"); 


Console.WriteLine (stateName); 
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} 
catch 
{ 
Console.WriteLine ("查询 失败 ") ; 
} 


Console.ReadLine(); 


编译 并 运行 该 程序 。 程 序 运行 结果 如 图 10.10 所 示 。 


图 10.10 应 用 Web 服务 的 方法 执行 查询 


从 Main 方法 中 的 代码 可 以 看 出 ， 由 于 我 们 将 空间 查询 的 服务 进行 了 进一步 的 封装 ， 因 此 在 客 
户 端的 调用 非常 简单 ， 只 需要 新 创建 一 个 对 象 ， 然 后 调用 方法 即 可 实现 空间 查询 。 
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对 于 Web 应 用 程序 ， 功 能 的 开发 只 占 整 个 工作 量 的 一 部 分 ,还 需要 考虑 的 是 应 用 程序 的 
安全 与 性 能 。 特 别 是 对 于 Web GIS， 由 于 通常 系统 中 的 空间 数据 安全 要 求 比 较 高 ， 而 且 由 于 
空间 数据 的 数据 量 比较 大 , 因此 特别 需要 开发 人 员 在 应 用 程序 的 安全 与 性 能 上 花费 较 大 精力 。 

因此 ， 本 章 就 来 介绍 Web 应 用 程序 的 安全 、 部 署 以 及 性 能 调 优 事宜 。 


11.1 应 用 程序 的 安全 
11.2 ”应 用 程序 的 部 署 
11.3 ”性 能 调 优 
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11.1 应 用 程序 的 安全 


对 于 Web 开发 人 员 来 说 ， 保 证 网 站 的 安全 是 一 个 关键 而 又 复杂 的 问题 。 保 护 某 个 站 点 需要 进 
行 仔细 的 规划 ， 网 站 管理 员 和 程序 员 必须 清楚 地 了 解 有 关 保 证 他 们 站 点 安全 的 选项 。 

ASP.NET 与 Microsoft NET Framework 及 Microsoft Internet. 信息 服务 (IIS) 协同 工作 ， 以 
提供 Web 应 用 程序 安全 性 。 若 要 帮助 保护 ASP.NET 应 用 程序 ， 应 该 执行 下 面 两 个 基本 功能 : 
O ”身份 验证 。 验 证 用 户 不 是 假冒 的 。 应 用 程序 获取 用 户 的 凭据 (各 种 形式 的 标识 ， 如 用 户 
名 和 密码 ) 并 通过 某 些 授权 机 构 验证 那些 凭据 。 如 果 这 些 凭据 有 效 ， 则 将 提交 这 些 凭 据 
的 实体 视 为 通过 身份 验证 ; 
O 授权 。 通过 对 已 验证 身份 授予 或 拒绝 特定 权限 来 限制 访问 权限 。 


11.1.0. 使 用 成 员 资格 管理 用 户 


ASP.NET 成 员 资格 (Membership 类 ) 提供 了 一 种 验证 和 存储 用 户 凭据 的 内 置 方 法 。 因 此 ， 
ASP.NET 成 员 资格 可 管理 网 站 中 的 用 户 身 份 验证 。 可 以 将 ASP.NET 成 员 资 格 与 ASP.NET Forms 
身份 验证 或 ASP.NET 登录 控件 一 起 使 用 以 创建 一 个 完整 的 用 户 身 份 验 证 系统 。 

ASP.NET 成 员 资 格 支 持 下 列 功能 : 


(1) 创建 新 用 户 和 密码 。 

(2) 将 成 员 资格 信息 (用 户 名 、 密 码 和 支持 数据 ) 存 储 在 Microsoft SQL Server. Active Directory 
或 其 他 数据 存储 区 。 

G) 对 访问 站 点 的 用 户 进行 身份 验证 。 可 以 以 编程 方式 验证 用 户 ， 也 可 以 使 用 ASP.NET 登 
录 控 件 创建 一 个 只 需 很 少 代码 或 无 需 代码 的 完整 身份 验证 系统 。 

(4) 管理 密码 ， 包 括 创 建 、 更 改 和 重 置 密码 。 根 据 选择 的 成 员 资 格 选 项 不 同 ， 成 员 资 格 系统 
还 可 以 提供 一 个 使 用 用 户 提供 的 问题 和 答案 的 自动 密码 重 置 系统 。 

C5). 公开 经 过 身份 验证 的 用 户 的 唯一 标识 ， 可 以 在 应 用 程序 中 使 用 该 标识 ， 也 可 以 将 该 标识 
与 ASPNET 个 性 化 设置 和 角色 管理 〈 授 权 ) 系统 集成 。 

C6) 指定 自 定义 成 员 资格 提供 程序 ， 可 以 使 用 自己 的 代码 管理 成 员 资格 及 在 自 定义 数据 存储 
区 中 维护 成 员 资格 数据 。 


若 要 使 用 成 员 资格 ， 必 须 首先 为 站 点 配置 成 员 资格 。 主 要 分 为 下 面 的 步 又: 


CD 将 成 员 资格 选项 指定 为 网 站 配置 的 一 部 分 。 默 认 情 况 下 ， 成 员 资格 处 于 启用 状态 。 还 可 
以 指定 要 使 用 哪个 成 员 资格 提供 程序 。 实际 上 ,这 意味 着 指定 要 存储 成 员 资 格 信息 的 数据 库 的 类 
型 。) 默认 提供 程序 使 用 Microsoft SQL Server 数据 库 。 还 可 以 选择 使 用 Active Directory 存储 成 
员 资格 信息 ， 或 者 可 以 指定 自 定 义 提 供 程序 。 

(2) 将 应 用 程序 配置 为 使 用 Forms. 身份 验证 。 通 常 指定 应 用 程序 中 的 某 些 页 或 文件 夹 受到 
保护 ， 并 只 能 由 经 过 身份 验证 的 用 户 访问 。 
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OD 为 成 员 资格 定义 用 户 账户 。 可 以 通过 多 种 方式 执行 此 操作 。 可 以 创建 一 个 “新 用 户 ” 
ASP.NET 网 页 ， 在 该 网 页 中 收集 用 户 名 和 密码 〈 及 电子 邮件 地 址 〈 可 选 ) ) ， 然 后 使 用 一 个 名 为 
CreateUser 的 成 员 资格 函数 在 成 员 资格 系统 中 创建 一 个 新 用 户 。 或 者 ， 另 一 个 更 常用 的 ， 特 别 是 开 
发 期 间 更 常用 的 ， 是 使 用 网 站 管理 工具 ， 该 工具 提供 了 一 个 用 于 创建 新 用 户 的 类 似 向 导 的 界面 。 


其 实 不 仅 可 以 用 网 站 管理 工具 创建 用 户 ， 还 可 用 该 工具 配置 成 员 资格 与 身份 验证 。 可 以 通过 
Website 菜单 的 ASPNET Configuration 命令 ， 打 开 该 工具 。 首 先进 入 Home 选项 卡 ， 在 其 中 选择 
Security 选项 卡 ( 此 时 该 工具 自动 在 网 站 的 App. Data 目录 下 创建 Microsoft SQL Server 速成 版 数据 
库 文 件 ) ， 进 入 如 图 11.1 所 示 的 界面 。 在 该 界面 中 可 选 通过 “Select authentication type” 配 置 验证 
类 型 。 


Zh ASP.Net Web Application Administration — Microsoft Internet Explorer 
XQ) REO FEV KEA IAW 帮助 0 


" 
Oa- O ni6ósew--eccgsUsaQc"^ 


Hit Q 篇 http: //Localhost:2874/ asp. netwebadninfiles/securi ty/ securi ty. aspx 


ASP — Web Site Administration Tool How do 1 use this oo? © ji 


|| Home || Security || Application || Provider 


The current Roles are not 
authentication type enabled 

is Windows. User Enable roles 
management from Create or Manage 
within this tool is 

therefore disabled. 

Select authentication 

type 


图 11.1 利用 网 站 管理 工具 配置 成 员 资格 
现在 ， 就 可 以 使 用 成 员 资格 对 应 用 程序 中 的 用 户 进行 身份 验证 。 大 多 数 情 况 下 ， 将 需要 提供 一 
个 登录 窗 体 ， 它 可 能 是 一 个 单独 页 或 主页 上 的 一 个 专用 区 域 。 可 以 使 用 ASPNET TextBox 控件 手 


动 创建 登录 窗 体 ， 也 可 以 使 用 ASP.NET 登录 控件 。 由 于 已 将 应 用 程序 配置 为 使 用 Forms 身份 验 
证 ， 因 此 在 未 经 验证 的 用 户 请 求 一 个 受 保护 的 页 面 时 ，ASP.NET 将 自动 显示 登录 页 。 


11.1.2 ”使 用 角色 管理 授权 


建立 角色 的 主要 目的 是 为 应 用 系统 提供 一 种 管理 用 户 组 访问 规则 的 便捷 方法 。 创建 用 户 , 然后 
将 用 户 分 配 到 角色 。 典 型 的 应 用 是 创建 一 组 要 限制 为 只 有 某 些 用 户 可 以 访问 的 页 面 。 通 常 的 做 法 是 
将 这 些 受 限制 的 页 面 单 独 放 在 一 个 文件 夹 内 。 然 后 , 可 以 使 用 网 站 管理 工具 定义 允许 和 拒绝 访问 受 
限 文件 夹 的 规则 。 例如， 可 以 配置 站 点 以 使 成 员 和 经 理 可 以 访问 受 限 文件 夹 中 的 页 面 ， 并 拒绝 其 他 
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所 有 用 户 的 访问 。 如 果 未 被 授权 的 用 户 尝试 查看 受 限 制 的 页 面 ， 该 用 户 会 看 到 错误 消息 或 被 重 定向 
到 指定 的 页 面 。 
若 要 使 用 ASP.NET 角色 管理 ， 则 需要 使 用 如 下 所 示 的 设置 在 应 用 程序 的 Web.config 文件 中 
启用 它 : 
«roleManager 
enabled-"true" 


cacheRolesInCookie-"true" » 
«/roleManager» 


角色 的 典型 应 用 是 建立 规则 ， 用 于 允许 或 拒绝 对 页 面 或 文件 夹 的 访问 。 可 以 在 Web.config X 
件 的 authorization 元 素 部 分 中 设置 此 类 访问 规则 。 下 面 的 示例 允许 members. 角色 的 用 户 查看 名 为 
memberPages 的 文件 夹 中 的 页 面 ， 同 时 拒绝 任何 其 他 用 户 的 访问 : 


<configuration> 
<location path="memberPages"> 
<system.web> 
<authorization> 
<allow roles="members" /> 
<deny users="*" /> 


</authorization> 
</system.web> 
</location> 
<!-- 其 他 配置 信息 的 设置 --> 
<configuration> 


但 是 ASPNET 中 的 成 员 资源 与 角色 的 配合 使 用 只 能 到 页 面 层 次 ， 对 于 GIS 一 些 特 有 的 功能 ， 
例如 对 某 些 用 户 需 要 限制 查询 操作 ， 或 限制 某 些 用 户 浏览 某 些 图 层 的 操作 ，ASP.NET 没有 提供 ， 
也 不 可 能 提供 。 因 此 对 于 这 些 GIS 特殊 的 功能 ， 需 要 程序 员 编 码 实现 。 

下 面 的 代码 演示 了 如 果 根 据 用 户 的 角色 设置 图 层 的 可 见 性 、 隐 藏 工具 与 任务 。 

protected void Page PreRenderComplete (object sender, EventArgs e) ( 

// 检查 登录 用 户 的 角色 
if (!User.IsInRole(fullyEnabledRole)) ( 


// 1) 从 地 图 以 及 Toc 中 删除 某 图 层 
HideLayer(Mapl, layerToHide); 


// 2) 隐藏 地 图 信息 工具 


RemoveItemFromToolbar (Toolbarl, toolbarlItemToRemove); 


// 3) 隐藏 任务 1 
RemoveTask(TaskManagerl, taskToRemove); 
) 
将 某 图 层 设置 为 不 可 见 的 代码 如 下 : 


private void HideLayer(Map map, string layerName) 


{ 
// 遍历 所 有 Map Functionalities 
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foreach (IMapFunctionality mapFunct in map.GetFunctionalities()) ( 
string layerId = GetLayerId(layerName, mapFunct); 


// 设置 图 层 不 可 见 
if (!String.IsNullOrEmpty (layerId)) 
mapFunct.SetLayerVisibility(layerId, false); 
) 


// 找到 和 Map 关联 的 Toc 
Toc tocCtrl = FindControlOfType (typeof (Toc), Page.Controls) as Toc; 
if (tocCtrl !- null && tocCtrl.BuddyControl == map.ID) { 
// 移 除 之 前 隐藏 图 层 在 Toc 中 的 节点 
foreach (TreeViewPlusNode resource in tocCtrl.Nodes) ( 
TreeViewPlusNode nodeToRemove - null; 
foreach (TreeViewPlusNode layerNode in resource.Nodes) ( 
TreeViewPlusNode matchNode = 
FindNodeRecursive (layerNode, layerName); 
if (matchNode !- null) ( 
nodeToRemove - matchNode; 
break; 


) 
if (nodeToRemove !- null) 
nodeToRemove .Remove () ; 


) 
上 述 方法 利用 了 GetLayerld 方法 ， 根 据 图 层 名 称 获 取 图 层 的 id。 该 方法 的 代码 如 下 : 


private string GetLayerId(string layerName, 
IMapFunctionality mapFunctionality) 
t 

string layerId - String.Empty; 

string[] layerIDs, layerNames; 


// 查询 图 层 名 称 
mapFunctionality.GetLayers(out layerIDs, out layerNames); 
for (int i = 0; i < layerIDs.Length; i++) ( 


if (layerNames[i] -- layerName) ( 
layerId = layerIDs[i]; 
break; 

) 


) 
return layerlId; 


h 
在 HideLayer 方法 中 还 用 到 了 FindNodeRecursive 方法 ， 用 于 查找 指定 节点 。 该 方法 的 代码 如 
下 : 


private TreeViewPlusNode FindNodeRecursive (TreeViewPlusNode node, 
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string nodeName) { 

if (node.Text == nodeName) ( 
return node; 

} 

foreach (TreeViewPlusNode node2 in node.Nodes) { 
TreeViewPlusNode childNode = FindNodeRecursive (node2, nodeName); 
if (childNode != null) { 

return childNode; 


} 
return null; 


} 
从 工具 栏 中 删除 某 工具 的 代码 如 下 : 


private void RemoveltemFromToolbar(Toolbar toolbar, string toolbarItemName) 


t 
for (int i = 0; i < toolbar.ToolbarItems.Count; i++) ( 
if (toolbar.ToolbarItems[i].Name == toolbarItemName) { 
toolbar.ToolbarItems.RemoveAt (i); 
break; 


) 
删除 指定 名 称 任务 的 代码 如 下 : 


private void RemoveTask(TaskManager taskManager, string taskName) ( 
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string menuld - ""; 
foreach (Control ctl in taskManager.Controls) ( 
if (ctl.ID == taskToRemove) { 
// 得 到 任务 标题 ， 以 便 从 菜单 中 删除 
FloatingPanel queryTask = ctl as FloatingPanel; 
if (queryTask !- null) 
menuId - queryTask.Title; 
// 从 任务 管理 器 中 删除 该 任务 
taskManager.Controls.Remove (ctl); 
) 
) 
// 同时 需要 从 菜单 中 删除 该 任务 对 应 的 菜单 
// 找到 任务 管理 器 连接 的 菜单 控件 
Control mCtl = 
FindControlRecursive (taskManager.Page, taskManager.BuddyControl); 
if (mCtl != null && mCtl is Menu) { 


Menu menu = (Menu)mCtl; 
for (int i = 0; i < menu.Items.Count; i++) ( 
if (menu.Items[i].Text == menuId) { 


menu.Items.RemoveAt (i); 
break; 
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上 述 代 码 利用 了 FindControlRecursive 方法 查找 指定 控件 ， 该 方法 的 代码 如 下 : 


public static Control FindControlOfType (Type type, ControlCollection controls) 
t 
foreach (Control ctl in controls) ( 
if (type.IsInstanceOfType(ctl)) ( 
return ctl; 
) 
else if (ctl.HasControls()) ( 
Control childCtl = FindControlOfType (type, ctl.Controls); 
if (childCtl != null) ( 
return childCtl; 
) 
) 
) 
return null; 


} 
11.1.3 ”使 用 受 保护 的 配置 加 密 配置 信息 


不 用 可 读 或 容易 解码 的 格式 存储 高 度 敏感 的 信息 , 这 也 是 保护 应 用 程序 所 要 注意 的 一 部 分 。 人 敏 
感 信息 的 示例 包括 用 户 名 、 密 码 、 连 接 字符 串 和 加 密 密 钥 。 将 敏感 信息 以 不 可 读 的 格式 存储 ， 可 以 
使 攻击 者 很 难 获得 对 敏感 信息 的 访问 权限 (即使 攻击 者 获得 了 对 文件 、 数 据 库 或 其 他 存储 位 置 的 访 
问 权 限 ) ， 从 而 可 以 增强 应 用 程序 的 安全 性 。 

ASP.NET 应 用 程序 中 存储 敏感 信息 的 主要 位 置 之 一 是 Web.config 文件 。 为 了 帮助 保护 配置 文 
件 中 的 信息 ，ASP.NET 提供 了 一 项 称 为 “ 受 保护 配置 ”的 功能 ， 可 用 于 加 密 配置 文件 中 的 敏感 信 
息 。 

可 以 使 用 aspnet regiis.exe 对 Web.config 文件 的 节 进 行 加 密 并 管理 加 密 密 钥 。ASP.NET 在 处 
理 文件 时 对 配置 文件 进行 解密 。 因 此 ， 解 密 不 需要 任何 附加 代码 。 


11.14 ”显示 安全 的 错误 信息 


在 应 用 程序 显示 错误 信息 时 ,不 应 该 泄露 有 助 于 恶意 攻击 用 户 系统 的 信息 。 例如， 如果 应 用 程 
序 试图 登录 数据 库 时 没有 成 功 ， 则 显示 的 错误 信息 不 应 该 包括 它 正在 使 用 的 用 户 名 。 

有 许多 方法 可 以 控制 错误 信息 ， 包 括 : 

CD 将 应 用 程序 配置 为 不 向 远程 用 户 显示 详细 错误 信息 (远程 用 户 是 指 在 Web 服务 器 计算 
机 上 工作 但 未 请 求 页 的 用 户 ) ， 也 可 以 选择 将 错误 重 定 向 到 应 用 程序 页 。 

OD 只 要 可 行 就 包括 错误 处 理 ， 并 编写 自 定义 的 错误 信息 。 在 错误 处 理 程序 中 ， 可 以 进行 测 
试 以 确定 用 户 是 否 为 本 地 用 户 并 做 出 相应 的 响应 。 

G) 在 捕 提 所 有 未 处 理 异 常 并 将 它们 发 送 到 一 般 错误 页 的 页 级 别 或 应 用 程序 级 别 上 ， 创 建 全 
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局 错误 处 理 程序 。 这 样 ， 即 使 没有 预料 到 某 个 问题 ， 至 少 用 户 不 会 看 到 异常 页 。 
1. 将 应 用 程序 配置 为 不 向 远程 用 户 显示 错误 
在 应 用 程序 的 Web.config 文件 中 ， 对 customErrors 元 素 进行 以 下 更 改 : 


O 将 mode 属性 设置 为 RemoteOnly。 这 就 将 应 用 程序 配置 为 仅 向 本 地 用 户 ( 即 开发 人 员 ) 
显示 详细 的 错误 。 

O 包括 指向 应 用 程序 错误 页 的 defaultRedirect 属性 。 

O ”包括 将 错误 重 定向 到 特定 页 的 <error> 元 素 。 例 如 ， 可 以 将 标准 404 错误 (未 找到 页 ) 
重 定向 到 自 定义 的 应 用 程序 页 。 


下 面 的 代码 示例 显示 Web.config 文件 中 的 典型 customErrors 块 。 


<customErrors mode="RemoteOnly" defaultRedirect="AppErrors.aspx"> 
Xerror statusCode-"404" redirect-"NoSuchPage.aspx"/» 
Xerror statusCode-"403" redirect-"NoAccessAllowed.aspx"/» 
X/customErrors» 


2. 包含 错误 处 理 

在 任何 可 能 生成 错误 的 语句 周围 使 用 一 个 try-catch 块 。 

另 一 方面 ,可 以 选择 使 用 IsSLocal 属性 对 本 地 用 户 进行 测试 并 相应 地 修改 错误 处 理 。 值 127.0.0.1 
等 效 于 localhost， 指 示 浏 览 器 与 Web 服务 器 位 于 同一 台 计 算 机 上 。 

下 面 的 代码 示例 显示 一 个 错误 处 理 块 。 如 果 发 生 错误 ， 则 用 有 关 消息 的 详细 信息 加 载 Session 
状态 变量 ， 然 后 应 用 程序 显示 可 以 读 取 Session 变量 并 显示 错误 的 页 。 (有 意 写 入 此 错误 以 便 不 向 
用 户 提供 任何 可 利用 的 详细 信息 。) 如 果 用 户 是 本 地 用 户 ， 则 提供 不 同 的 错误 详细 信息 。 在 finally 
块 中 ， 释 放 开 放 式 资源 。 

try ( 


SqlConnectionl.Open(); 
sqlDataAdapterl.Fill(dsCustomersl); 


SI9 ga 从 


) 
catch (Exception ex) { 
if(Request.IsLocal) ( 
Session["CurrentError"] - ex.Message; ] 
else ( 
Session["CurrentError"] - "Error processing page."; 
) 
Server.Transfer("ApplicationError.aspx"); 
} 
finally { 
this.sqglConnectionl.Close(); 


jj 
3. 创建 全 局 错误 处 理 程序 
若 要 在 页 面 中 创建 全 局 处 理 程序 ， 则 需要 创建 System.Web.ULTemplateControl Error 事件 的 处 
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: 


理 程序 。 若 要 创建 应 用 程序 范围 的 错误 处 理 程序 ， 这 需要 在 Globalasax 文件 中 将 代码 添加 到 
System.Web.HttpApplication Error 事件 。 只 要 页 面 或 应 用 程序 中 发 生 未 处 理 的 异常 ， 就 会 相应 地 调 
用 这 些 方法 。 可 以 从 GetLastError 方法 获取 有 关 最 新 错误 的 信息 。 
下 面 的 代码 示例 显示 一 个 处 理 程序 ， 它 获取 有 关 当前 错误 的 信息 ， 将 其 放 在 Session 变量 中 ， 
然后 调用 可 以 提取 和 显示 错误 信息 的 一 般 性 错误 处 理 页 。 
protected void Application Error (Object sender, EventArgs e) { 
Session["CurrentError"] = "Global: " + Server.GetLastError().Message; 


Server.Transfer("lasterr.aspx"); 


} 


11.1.5 “防止 拒绝 服务 威胁 


恶意 用 户 危害 应 用 程序 的 一 种 间接 方式 是 使 其 不 可 用 .恶意 用 户 可 以 使 应 用 程序 太 忙 而 无 法 为 
其 他 用 户 提供 服务 ， 或 者 仅仅 使 应 用 程序 出 现 故 障 。 请 遵循 下 面 这 些 原则 : 


(1) 关闭 或 释放 使 用 的 任何 资源 。 例 如 ， 在 使 用 完毕 后 ， 始 终 关 闭 数据 连接 和 数据 读 取 器 ， 
而 且 始终 关闭 文件 。 

(2) 使 用 错误 处 理 机 制 〈 例 如 ，try-catch 块 ) 。 包 含 finally 块 ， 以 便 万 一 失败 就 可 以 在 其 
中 释放 资源 。 

G) 将 IIS 配置 为 使 用 调节 ， 这 样 可 以 防止 应 用 程序 消耗 过 多 的 CPU. 

(4) 在 使 用 或 存储 用 户 输入 之 前 ， 测 试 它 的 大 小 限制 。 

C50 对 数据 库 查询 设置 大 小 保护 措施 ， 以 防止 大 型 查询 耗 尽 系统 资源 。 

(6) 如 果 文 件 上 载 是 应 用 程序 的 一 部 分 ， 则 对 它们 的 大 小 加 以 限制 。 可 以 使 用 类 似 下 面 代码 
示例 的 语法 在 Web.config 文件 中 设置 限制 (其 中 maxRequestLength 值 以 千 字 节 为 单位 ) : 

<configuration> 

<system.web> 
<httpRuntime maxRequestLength="4096" /> 


</system.web> 
</configuration> 


还 可 以 使 用 RequestLengthDiskThreshold 属性 来 减少 大 型 上 载 和 窗 体 发 布 所 需 的 内 存 开销 。 


11.2 ”应 用 程序 的 部 署 


由 于 使 用 Web ADF 的 Web 应 用 程序 是 一 个 典型 的 ASP.NET 程序 ， 因 此 部 署 比较 简单 ， 最 简 
单 的 方法 是 将 开发 环境 中 的 程序 复制 到 目标 计算 机 的 IIS. 目录 中 即 可 。 但 是 我 们 可 以 使 用 ASP.NET 
2.0 的 预 编译 功能 提高 系统 响应 速度 以 及 保护 源 代码 。 

默认 情况 下 ， 在 用 户 首次 请 求 资源 (如 网 站 的 一 个 页 面 ) 时， 将 动态 编译 ASP.NET 网 页 和 代 
码 文件 。 第 一 次 编译 页 和 代码 文件 之 后 , 会 缓存 编译 后 的 资源 ,这样 将 大 大 提高 随后 对 同一 页 提出 
的 请 求 的 效率 。 
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ASP.NET 还 可 以 预 编译 整个 站 点 ， 然 后 再 提供 给 用 户 使 用 。 这 样 做 有 很 多 好 处 ， 其 中 包括 : 


(1) 可 以 加 快 用 户 的 响应 时 间 ， 因 为 页 和 代码 文件 在 第 一 次 被 请 求 时 无 须 编译 。 这 对 于 经 常 
更 新 的 大 型 站 点 尤其 有 用 。 

(2) 可 以 在 用 户 看 到 站 点 之 前 识别 编译 时 的 错误 。 

G) 可 以 创建 站 点 的 已 编译 版 本 ， 并 将 该 版 本 部 署 到 成 品 服务 器 ， 而 无 须 使 用 源 代码 。 


ASP.NET 提供 了 两 个 预 编译 站 点 选项 : 


CD 预 编译 现 有 站 点 。 如 果 希 望 提高 现 有 站 点 的 性 能 并 对 站 点 执行 错误 检查 ， 那 么 此 选项 十 
分 有 用 。 
(2) 针对 部 署 预 编译 站 点 。 此 选项 将 创建 一 个 特殊 的 输出 ,可 以 将 该 输出 部 署 到 成 品 服务 器 。 


另外 ， 可 以 预 编译 一 个 站 点 ， 使 它 成 为 只 读 的 或 可 以 更 新 的 站 点 。 

当 仅 针对 部 署 进行 预 编译 时 ， 编 译 器 实质 上 将 基于 正常 情况 下 在 运行 时 编译 的 所 有 ASP.NET 
源 文件 来 生成 程序 集 。 其 中 包括 页 中 的 程序 代码 、.cs 和 .vb 类 文件 以 及 其 他 代码 文件 和 资源 文件 。 
编译 器 将 从 输出 中 移 除 所 有 源 代码 和 标记 。 在 生成 的 布局 中 ， 为 每 个 .aspx 文件 生成 编译 后 的 文件 
(扩展 名 为 .compiled) ， 该 文件 包含 指向 该 页 相应 程序 集 的 指针 。 

要 更 改 网 站 (包括 页 的 布局 ) ， 必 须 更 改 原始 文件 ， 重 新 编译 站 点 并 重新 部 署 布局 。 唯 一 的 例 
外 是 站 点 配置 ， 可 以 更 改 成 品 服务 器 上 的 Web.config 文件 ， 而 无 须 重新 编译 站 点 。 

“ 仅 针 对 部 署 进行 预 编译 ”选项 不 仅 为 ASPX 页 面 提供 了 最 大 程度 的 保护 ， 还 提供 了 最 佳 启 
动 性 能 。 利 用 ASP.NET 编译 工具 (Aspnet compiler.exe) 可 以 就 地 对 应 用 程序 进行 预 编译 。 

就 地 预 编译 ASP.NET 网 站 的 命令 如 下 : 


aspnet compiler -v /virtualPath 


其 中 virtualpath 参数 指示 网 站 的 Internet. 信息 服务 (IIS) 虚拟 路 径 。 
预 编译 ASPNET 网 站 以 进行 部 署 的 命令 如 下 : 


aspnet compiler -v virtualPath targetPath 


使 用 -u 选项 将 以 下 面 的 方式 编译 应 用 程序 ， 可 以 对 编译 好 的 应 用 程序 中 的 某 些 文件 做 出 更 改 ， 
而 无 须 重新 编译 该 应 用 程序 。 Aspnet_compiler.exe 区 分 静态 和 动态 文件 类 型 之 间 的 不 同 , 并 在 创建 
生成 的 应 用 程序 时 ， 以 不 同 的 方式 对 它们 进行 处 理 。 
O 静态 文件 类 型 是 指 那些 没有 关联 的 编译 器 或 生成 提供 程序 的 文件 类 型 ， 例 如 具 
有 .css. .gif. .htm. .html. jpg. js 等 扩展 名 的 文件 。 这 些 文件 只 是 复制 到 目标 位 置 ， 
并 且 在 保留 的 目录 结构 中 保持 它们 的 相对 位 置 ; 
O ”动态 文件 类 型 是 指 那些 具有 关联 的 编译 器 或 生成 提供 程序 的 文件 类 型 ， 包 括 具 有 
ASP.NET 特定 文件 扩展 名 (如 .asax. .ascx. .ashx. .aspx. .browser. .master 等 ) 的 文 
件 。 ASP.NET 编译 工具 从 这 些 文件 生成 程序 集 。 如 果 省 略 -u 选 项， 该 工具 还 会 创建 具有 
文件 扩展 名 .COMPILED 的 文件 ， 这 些 文件 将 原始 源 文件 映射 到 它们 的 程序 集 。 为 确保 
保留 应 用 程序 源 的 目录 结构 ， 该 工具 在 目标 应 用 程序 的 相应 位 置 中 生成 占 位 符 文件 。 


必须 使 用 -u 选项 ， 以 指示 可 以 修改 编译 好 的 应 用 程序 的 内 容 。 和 否则 ， 将 忽略 后 续 修改 或 者 导 
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臻 运行 时 错误 。 
11.3 ”性 能 调 优 


ArcGIS Server 产品 的 强大 功能 往往 给 了 有 些 用 户 带 来 一 定 的 认识 误区 。 有 些 用 户 会 认为 可 以 
把 C/S 程序 的 使 用 模式 和 数据 照搬 到 ArcGIS Server 的 应 用 系统 中 。ArcGIS Server 的 应 用 是 B/S 的 
应 用 ， 涉 及 到 数据 库 、Web 服务 器 、ArcGIS 服务 器 与 浏览 器 ， 任 何 一 个 环节 都 有 可 能 出 现 问 题 ， 
所 以 ArcGIS Server 系统 需要 很 好 的 设计 和 规划 , 简单 的 功能 移植 只 能 得 到 低 效率 的 ArcGIS Server 
应 用 。 

其 实 ArcGIS Server 的 应 用 系统 往往 都 比较 大 ， 特 别 是 数据 量 都 比较 大 。 用 户 都 希望 把 大 量 的 
数据 都 通过 网 络 共享 给 广大 的 浏览 器 用 户 。 由 于 ArcGIS Server 简单 功能 的 系统 的 构建 是 非常 简单 
的 ， 用 户 很 容易 就 搭建 出 来 了 ， 因 此 当 用 户 把 大 量 的 数据 往 ArcGIS Server 系统 上 搬 时 并 发 现 速度 
非常 慢 时 ， 用 户 往往 会 认为 是 ArcGIS Server 产品 的 速度 慢 ， 因 此 性 能 调整 的 考虑 角度 也 仅仅 从 
ArcGIS Server 产品 角度 入 手 ， 这 也 给 ArcGIS Server 系统 的 性 能 调整 带 来 一 定 的 误区 ， 忽 略 了 
ArcGIS Server 系统 中 的 重要 组 成 部 分 一 数据 的 性 能 。 

当然 , 不 同 应 用 系统 有 不 同 的 情况 ， 因 此 在 性 能 调整 方面 都 要 看 具体 系统 情况 ， 这 里 简单 介绍 
ArcGIS Server 应 用 性 能 调整 的 几 个 大 的 方面 。 


11.3.1 数据 方面 


ArcGIS Server 应 用 毕竟 是 B/S 程序 ， 网 络 传输 问题 很 容易 成 为 它 的 性 能 瓶颈 ， 除 了 增加 网 络 
带宽 之 外 ， 当 然 也 尽量 要 减少 数据 量 ， 主 要 的 原则 是 按 需 使 用 数据 。 

比如 在 对 数据 进行 了 分 析 之 后 , 发现 数据 节点 非常 密 , 在 不 影响 数据 的 浏览 精度 的 情况 下 使 用 
简化 操作 ， 减 少数 据 量 。 

如 果 是 文件 方式 的 话 ， 就 没有 什么 可 调整 性 ， 如 果 是 SDE 中 的 数据 ， 那 么 主要 从 两 个 方面 对 
数据 进行 调整 ， 一 个 是 属性 字段 的 索引 ， 一 个 是 空间 索引 大 小 的 调整 。 


O ”属性 字段 索引 : 特别 是 对 于 经 常 要 进行 搜索 的 字段 都 要 进行 索引 的 建立 。 

O ”空间 索引 大 小 的 调整 : 会 非常 影响 数据 的 浏览 和 空间 查询 的 速度 。 空 间 索 引 大 小 的 调整 
要 依照 数据 的 每 个 单元 的 大 小 而 定 。 一 般 建 立 2 级 就 可 以 ， 第 二 级 是 第 一 级 的 4~5 倍 ， 
第 一 级 是 要 素 类 中 大 多 数 要 素 的 大 小 。 这 个 设 定 的 效果 可 以 在 桌面 产品 中 进行 验证 。 


二 维 的 地 图 服务 都 是 通过 发 布 mxd 文件 的 ， 因 此 mxd 的 文档 组 织 也 非常 重要 。 主 要 包括 减少 
图 层 数 量 ， 图 层 的 按 比例 显示 ， 减 少 复杂 符号 ， 减 少 注 记 等 。 


11.3.2 ”服务 方面 


如 果 应 用 中 要 包含 大 量 的 图 层 ， 比 如 上 百 个 ,不 要 把 所 有 的 图 层 都 放 在 一 个 服务 中 , 可 以 把 上 
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百 个 图 层 进行 拆 分 ， 做 成 几 个 服务 ， 然 后 在 应 用 中 进行 组 合 ， 这 样 就 可 以 有 多 个 进程 来 完成 ， 从 而 
减少 处 理 时 间 。 

另外 , 这 样 拆 分 的 另 一 个 好 处 就 是 可 以 根据 不 同 的 用 户 使 用 不 同 的 服务 , 没有 必要 每 个 人 都 添 
加 所 有 的 数据 ， 这 也 是 按 需 使 用 数据 的 原则 。 

服务 设置 也 有 两 个 方面 ,一 个 是 服务 的 池 化 和 非 池 化 设置 ,一 个 是 服务 的 缓存 的 设置 。 池 化 服 
务 的 效率 比 非 池 化 服务 的 效率 要 高 ， 而 且 池 化 服务 可 以 创建 缓存 来 更 进一步 提供 高 速度 。 


11.3.3 ”应 用 系统 的 配置 与 部 署 方 面 


把 ArcGIS Server 应 用 进行 分 布 式 部 署 , 由 一 个 SOM 和 多 个 SOC 组 成 , SOM 起 到 负载 均衡 的 
作用 ， 有 具体 的 请 求 由 SOC 来 完成 。 大 型 系统 利用 多 台 服 务 器 的 应 用 系统 可 采用 如 图 11.2 所 示 的 结 
构 。 


"em 


图 11.2 大 型 Web GIS 应 用 系统 部 署 方案 


在 图 11.2 中 ， 网 络 分 派 器 将 让 多 个 Web 服务 器 像 一 个 单一 系统 一 样 运行 。 该 软件 驻 留 于 服务 
器 和 Internet 之 间 ， 提 供 负载 平衡 和 动态 配置 ， 若 其 中 某 个 服务 器 脱 机 时 它 还 提供 失效 转移 
Cfail-over) 功能 。ArcGIS 服务 器 宿主 各 种 GIS 资源 ， 例 如 地 图 资源 、 地 理 编 码 资源 等 ， 并 将 它们 
封装 为 服务 提供 给 客户 端 应 用 。GIS 服务 器 本 身 包括 两 部 分 ， 分 别 是 SOM 与 SOCs, 一 个 SOM 和 
一 个 或 多 个 SOC。 客 户 端 发 送 请 求 到 SOM, SOM 将 分 配 的 资源 提供 给 客户 端 , 通过 SOM 对 SOC 
进行 调度 与 管理 。 

该 部 署 架 构 具 有 如 下 特点 : 


O ”高 可 靠 性 (HA) 。 利 用 集群 管理 软件 ， 当 主 服 务 器 发 生 故障 时 ， 备 份 服务 器 能 够 自动 接 
管 主 服务 器 的 工作 ， 并 及 时 切换 过 去 ， 以 实现 对 用 户 的 不 间断 服务 。 

O ”高 性 能 计算 (HP) 。 即 充分 利用 集群 中 的 每 一 台 计 算 机 的 资源 ， 实 现 复杂 运算 的 并 行 处 
理 。 


O ”负载 平衡 。 即 把 负载 压力 根据 某 种 算法 合理 分 配 到 集群 中 的 每 一 台 计 算 机 上 ， 以 减轻 主 
服务 器 的 压力 ， 降 低 对 主 服 务 器 的 硬件 和 软件 要 求 。 
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11.3.4 .NET 程序 代码 调 优 


对 程序 代码 调 优 可 以 遵循 以 下 几 个 原则 。 


CD 减 小 没有 必要 的 操作 

对 象 的 创建 是 个 很 昂贵 的 工作 , 所 以 应 当 尽 量 减少 对 象 的 创建 , 在 需要 的 时 候 声 明 它 , 初始 化 ， 
不 要 重复 初始 化 一 个 对 象 ,尽量 能 做 到 再 使 用 , 而 用 完 后 置 null 有 利于 垃圾 收集 ,让 类 实现 Cloneable 
接口 ， 同 时 采用 工厂 模式 ， 将 减少 类 的 创建 ， 每 次 都 是 通过 clone() 方 法 来 获得 对 象 。 另 外 使 用 接 
口 也 能 减少 类 的 创建 。 对 于 成 员 变量 的 初始 化 也 应 尽量 避免 , 特别 是 在 一 个 类 派生 另 一 个 类 时 。 

异常 抛 出 对 性 能 不 利 。 抛 出 异常 首先 要 创建 一 个 新 的 对 象 。 只 要 有 异常 被 抛 出 ,就 必须 调整 调 
用 堆栈 ,因为 在 处 理 过 程 中 创建 了 一 个 新 的 对 象 。 异常 只 能 用 于 错误 处 理 ,不 应 该 用 来 控制 程序 流 
程 。 

此 外 ， 关 闭 Debug 输出 ， 尽 量 少 用 串 行 化、 同步 操作 和 耗 时 昂贵 的 服务 。 


(2) 使 用 合适 的 类 型 

当 原 始 类 型 不 能 满足 我 们 要 求 时 ， 使 用 复杂 类 型 。 在 涉及 到 字符 运算 时 ， 使 用 StringBuffer。 

带 有 final 修饰 符 的 类 是 不 可 派生 的 ， 如 果 指 定 一 个 类 为 final， 则 该 类 所 有 的 方法 都 是 final。 
编译 器 会 寻找 机 会 内 联 所 有 的 final 方法 , 这 将 能 够 使 性 能 平均 提高 50%。 类 的 属性 和 方式 使 用 final 
或 者 static 修饰 符 也 是 有 好 处 的 。 

调用 方法 时 传递 的 参数 以 及 在 调用 中 创建 的 临时 变量 都 保存 在 栈 中 , 速度 较 快 。 所 以 尽量 使 用 
局 部 变量 。 

ArrayList 和 Vector, HashMap 和 Hashtable 是 经 常用 到 的 类 , 前 者 不 支持 同步 , 后 者 支持 同步 ， 
前 者 性 能 更 好 ， 大 多 数 情况 下 选择 前 者 。 
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ASP.NET 2.0 允许 开发 人 员 将 资源 嵌入 到 .NET 程序 集中 。 例 如 ， 我 们 创建 了 使 用 一 些 图 像 文 
件 的 自 定义 任务 , 当然 并 且 希 望 该 任务 可 以 在 多 个 应 用 系统 中 重复 使 用 , 这 时 我 们 可 以 将 这 些 图 像 
文件 嵌入 到 动态 链接 库 中 ,这 样 可 以 避免 既 需 要 复制 动态 链接 库 ， 又 需要 复制 图 像 文件 。 同样 可 以 
将 JavaScript 与 其 他 类 型 的 资源 以 及 页 面 嵌 入 到 程序 集中 。 使 用 时 ， 可 以 通过 URL 来 获取 该 资源 。 
该 URL 使 用 WebResource.axd 处 理 程序 来 获取 嵌入 资源 。 


(4) 尽量 使 用 缓存 
使 用 缓存 能 大 大 提高 系统 的 性 能 。 我 们 在 第 4 章 中 介绍 了 如 何 使 用 缓存 。 


11.3.5 ArcGIS Server 的 代码 的 调 优 


可 以 通过 设置 超时 或 查询 操作 的 参数 等 来 优化 ArcGIS Server 代码 。 
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1. 设置 超时 


使 用 Web ADF 的 应 用 程序 可 以 在 三 个 层面 考虑 超时 : Web ADF 超时 (客户 端 ) ~ ASP.NET 
会 话 超时 (Web 端 ) 、 数 据 源 超时 〈GIS 服务 器 端 ) o 
display commonjs 文件 中 的 如 下 代码 设置 了 Web ADF 超时 : 


var maximumLapseTime = 10; 


该 超时 值 的 单位 为 分 钟 。 要 注意 的 是 ， 默 认 时 ， 该 文件 作为 Web 资源 保存 到 了 客户 端 。 要 在 
Web ADF 站 点 中 改变 该 值 ， 需 要 在 Web ADF 控件 中 改变 下 面 的 属性 : 

UseDefaultWebResources = False 

WebResourceLocation = «JavaScript 文件 所 在 的 相对 路 径 > 

将 UseDefaultWebResources 设置 为 False， 意 味 着 将 使 用 WebResourceLocation 属性 指定 的 值 
来 定位 JavaScript 文件 。WebResourceLocation 的 默认 值 为 /aspnet clienUESRI/WebADF/JavaScript/。 

ASP.NET 会 话 超时 可 以 在 web.config 文件 中 设置 。 默 认 值 为 20 分 钟 。 要 在 应 用 程序 中 改变 该 
值 ， 在 web.config 文件 中 的 <system.web> 元 素 部 分 加 入 如 下 配置 : 


<sessionState timeout="10"/> 


上 述 值 将 降低 使 用 非 池 化 ArcGIS Server 服务 的 Web 应 用 程序 的 效率 。 这 是 由 于 默认 会 话 超时 
是 20 分 钟 ， 如 果 Web 应 用 程序 中 ， 在 20 分 钟 里 启动 了 多 个 会 话 ， 每 个 会 话 试图 创建 并 拥有 一 个 
服务 器 对 象 实例 。 如 果 GIS 服务 器 上 没有 更 多 的 实例 可 用 ， 就 会 发 生 许多 问题 。 如 果 需 要 在 Web 
应 用 程序 中 使 用 非 池 化 ArcGIS Server 服务 ， 可 以 将 会 话 超时 值 设 置 为 更 短 时 间 ， 或 重新 启动 服务 
器 对 象 。 

数据 源 提供 程序 管理 数据 源 超时 。 例 如 ，ArcIMS 管理 员 可 改变 处 理 请 求 的 空间 服务 器 的 时 间 
分 配 。 


2. 查询 参数 记录 


在 进行 空间 查询 操作 时 ， 可 以 通过 将 MaxRecords 设置 为 较 小 的 值 来 提高 查询 效率 。 此 外 ， 对 
于 只 需要 返回 属性 设置 的 查询 , 通过 RetumADFGeometries 属性 设置 为 false, 指定 查询 结果 不 返回 
几何 图 形 数 据 ， 可 以 大 大 提高 服务 器 的 响应 速度 。 


3. 维护 用 户 状态 


Web 本 身 是 无 状态 的 ， 每 个 请 求 分 别 与 服务 器 连接 。 但 是 对 于 Web 应 用 程序 ， 需 要 在 请 求 之 
间 提 供 连续 性 。 例 如 ， 地 图 应 用 程序 需要 记忆 在 用 户 界面 上 当前 显示 的 地 图 的 返回 ， 只 有 这 样 才能 
正确 执行 放大 、 缩 小 与 漫游 操作 。 

同样 , 可 以 在 三 个 不 同 的 层面 来 保存 用 户 状态 : 客户 端 、Web 端 与 GIS 服务 器 端 。 在 Web ADF 
9.2 中 ， 主 要 使 用 Web 端 来 维护 状态 信息 。 只 有 在 使 用 非 池 化 ArcGIS Server 资源 时 ，GIS 服务 器 
才 维 护 状 态 。 

有 时 还 需要 在 不 同 的 会 话 之 间 保 存 状态 。 例 如 ， 可 能 需要 保存 用 户 地 图 当前 的 显示 范围 、 数 据 
中 选择 的 要 素 ， 以 便 用 户 再 次 登录 时 恢复 用 户 界 面 。Web ADF 没有 提供 保存 该 类 型 的 状态 的 功能 ， 
这 需要 开发 人 员 自 己 完成 。 


